# janakarthi19/python architecture

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

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

## Overview

This repository is a collection of independent Python command-line scripts rather than one integrated application. Its main workflows include scraping and exporting Hacker News stories, managing a small in-memory to-do list, transforming PDFs, sending templated email, translating text, and downloading media. The downloader’s standalone script contains the implemented workflow; the package entry point is only a greeting stub. The graph follows visible calls and data transfers in excerpts; no README workflow documentation was provided.

Main entry points: [`Web_Scraping.py`](https://github.com/janakarthi19/python/blob/main/Web_Scraping.py) (Hacker News scraper), [`youtube_video_download/main.py`](https://github.com/janakarthi19/python/blob/main/youtube_video_download/main.py) (Download workflow), [`TodoList.py`](https://github.com/janakarthi19/python/blob/main/TodoList.py) (To-do list), [`PDF.py`](https://github.com/janakarthi19/python/blob/main/PDF.py) (PDF merger)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_data["Data collection"]
  node_scraper["Hacker News scraper<br/>[Web_Scraping.py]"]
  node_csv_file["CSV export<br/>[Web_Scraping.py]"]
  node_excel_file["Excel export<br/>[Web_Scraping.py]"]
  node_news_db[("SQLite database<br/>[Web_Scraping.py]")]
end

subgraph group_utilities["Personal utilities"]
  node_todo["To-do list<br/>[TodoList.py]"]
  node_pdf_merge["PDF merger<br/>[PDF.py]"]
  node_pdf_inputs["PDF inputs<br/>[PDF.py]"]
  node_pdf_watermark["Watermark output<br/>[PDF.py]"]
  node_email_sender["Email sender<br/>[email_Sender.py]"]
  node_email_template["HTML template<br/>[email_Sender.py]"]
  node_translator["Text translator<br/>[Translator.py]"]
  node_download_main["Download workflow<br/>[main.py]"]
  node_download_settings["Download settings<br/>[main.py]"]
  node_download_folder["Downloads folder<br/>[main.py]"]
end

subgraph group_learning["Practice programs"]
  node_guessing["Guessing game<br/>[Guessing_Game.py]"]
  node_patterns["Pattern printer<br/>[Patterns.py]"]
end

node_hn_site["Hacker News"]
node_todo_user(("To-do user"))
node_smtp["Gmail SMTP"]
node_translation_service["Translation library"]
node_media_user(("Downloader user"))
node_yt_dlp["yt-dlp downloader"]

node_scraper -->|"fetches pages"| node_hn_site
node_scraper -->|"writes CSV"| node_csv_file
node_scraper -->|"writes Excel"| node_excel_file
node_scraper -->|"inserts stories"| node_news_db
node_todo_user -->|"enters choices"| node_todo
node_todo -->|"adds edits deletes"| node_todo
node_pdf_inputs -->|"provides PDFs"| node_pdf_merge
node_pdf_merge -->|"writes PDF"| node_pdf_watermark
node_email_template -->|"provides HTML"| node_email_sender
node_email_sender -->|"sends message"| node_smtp
node_translator -->|"translates text"| node_translation_service
node_media_user -->|"enters URL"| node_download_main
node_download_main -->|"gets options"| node_download_settings
node_download_settings -->|"creates folder"| node_download_folder
node_download_main -->|"downloads media"| node_yt_dlp
node_guessing -->|"checks guesses"| node_guessing
node_patterns -->|"prints patterns"| node_patterns

click node_scraper "https://github.com/janakarthi19/python/blob/main/Web_Scraping.py"
click node_csv_file "https://github.com/janakarthi19/python/blob/main/Web_Scraping.py"
click node_excel_file "https://github.com/janakarthi19/python/blob/main/Web_Scraping.py"
click node_news_db "https://github.com/janakarthi19/python/blob/main/Web_Scraping.py"
click node_todo "https://github.com/janakarthi19/python/blob/main/TodoList.py"
click node_pdf_merge "https://github.com/janakarthi19/python/blob/main/PDF.py"
click node_pdf_inputs "https://github.com/janakarthi19/python/blob/main/PDF.py"
click node_pdf_watermark "https://github.com/janakarthi19/python/blob/main/PDF.py"
click node_email_sender "https://github.com/janakarthi19/python/blob/main/email_Sender.py"
click node_email_template "https://github.com/janakarthi19/python/blob/main/email_Sender.py"
click node_translator "https://github.com/janakarthi19/python/blob/main/Translator.py"
click node_download_main "https://github.com/janakarthi19/python/blob/main/youtube_video_download/main.py"
click node_download_settings "https://github.com/janakarthi19/python/blob/main/youtube_video_download/main.py"
click node_download_folder "https://github.com/janakarthi19/python/blob/main/youtube_video_download/main.py"
click node_guessing "https://github.com/janakarthi19/python/blob/main/Guessing_Game.py"
click node_patterns "https://github.com/janakarthi19/python/blob/main/Patterns.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_scraper,node_csv_file,node_excel_file,node_news_db,node_todo_user,node_media_user toneBlue
class node_todo,node_pdf_merge,node_pdf_inputs,node_pdf_watermark,node_email_sender,node_email_template,node_translator,node_download_main,node_download_settings,node_download_folder toneAmber
class node_guessing,node_patterns toneMint
class node_hn_site,node_smtp,node_translation_service,node_yt_dlp toneIndigo
```

## Components

### Data collection

- [Hacker News scraper](https://github.com/janakarthi19/python/blob/main/Web_Scraping.py): `Web_Scraping.py`
- [CSV export](https://github.com/janakarthi19/python/blob/main/Web_Scraping.py): `Web_Scraping.py`
- [Excel export](https://github.com/janakarthi19/python/blob/main/Web_Scraping.py): `Web_Scraping.py`
- [SQLite database](https://github.com/janakarthi19/python/blob/main/Web_Scraping.py): `Web_Scraping.py`

### Personal utilities

- [To-do list](https://github.com/janakarthi19/python/blob/main/TodoList.py): `TodoList.py`
- [PDF merger](https://github.com/janakarthi19/python/blob/main/PDF.py): `PDF.py`
- [PDF inputs](https://github.com/janakarthi19/python/blob/main/PDF.py): `PDF.py`
- [Watermark output](https://github.com/janakarthi19/python/blob/main/PDF.py): `PDF.py`
- [Email sender](https://github.com/janakarthi19/python/blob/main/email_Sender.py): `email_Sender.py`
- [HTML template](https://github.com/janakarthi19/python/blob/main/email_Sender.py): `email_Sender.py`
- [Text translator](https://github.com/janakarthi19/python/blob/main/Translator.py): `Translator.py`
- [Download workflow](https://github.com/janakarthi19/python/blob/main/youtube_video_download/main.py): `youtube_video_download/main.py`
- [Download settings](https://github.com/janakarthi19/python/blob/main/youtube_video_download/main.py): `youtube_video_download/main.py`
- [Downloads folder](https://github.com/janakarthi19/python/blob/main/youtube_video_download/main.py): `youtube_video_download/main.py`

### Practice programs

- [Guessing game](https://github.com/janakarthi19/python/blob/main/Guessing_Game.py): `Guessing_Game.py`
- [Pattern printer](https://github.com/janakarthi19/python/blob/main/Patterns.py): `Patterns.py`

### Other components

- **Hacker News**
- **To-do user**
- **Gmail SMTP**
- **Translation library**
- **Downloader user**
- **yt-dlp downloader**

## Connections

- Hacker News scraper → Hacker News: fetches pages (evidence: `Web_Scraping.py`)
- Hacker News scraper → CSV export: writes CSV (evidence: `Web_Scraping.py`)
- Hacker News scraper → Excel export: writes Excel (evidence: `Web_Scraping.py`)
- Hacker News scraper → SQLite database: inserts stories (evidence: `Web_Scraping.py`)
- To-do user → To-do list: enters choices (evidence: `TodoList.py`)
- To-do list → To-do list: adds edits deletes (evidence: `TodoList.py`)
- PDF inputs → PDF merger: provides PDFs (evidence: `PDF.py`)
- PDF merger → Watermark output: writes PDF (evidence: `PDF.py`)
- HTML template → Email sender: provides HTML (evidence: `email_Sender.py`)
- Email sender → Gmail SMTP: sends message (evidence: `email_Sender.py`)
- Text translator → Translation library: translates text (evidence: `Translator.py`)
- Downloader user → Download workflow: enters URL (evidence: `youtube_video_download/main.py`)
- Download workflow → Download settings: gets options (evidence: `youtube_video_download/main.py`)
- Download settings → Downloads folder: creates folder (evidence: `youtube_video_download/main.py`)
- Download workflow → yt-dlp downloader: downloads media (evidence: `youtube_video_download/main.py`)
- Guessing game → Guessing game: checks guesses (evidence: `Guessing_Game.py`)
- Pattern printer → Pattern printer: prints patterns (evidence: `Patterns.py`)
