# tuomaskivioja/3-simple-python-projects architecture

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

- Interactive diagram: https://gitdiagram.com/tuomaskivioja/3-simple-python-projects
- Repository: https://github.com/tuomaskivioja/3-simple-python-projects

## Overview

This repository is a small collection of standalone Python utilities, not one integrated application. Its user-facing workflows are image batch editing, PDF merging, and YouTube video downloading. The source excerpts show each script's runtime actions; the README is empty, so no additional documented capabilities or cross-tool relationships are established.

Main entry points: [`ytDownloader.py`](https://github.com/tuomaskivioja/3-simple-python-projects/blob/master/ytDownloader.py) (YouTube downloader), [`imageProcessor/photoEditor.py`](https://github.com/tuomaskivioja/3-simple-python-projects/blob/master/imageProcessor/photoEditor.py) (Batch photo editor), [`pdf/pdfMerger.py`](https://github.com/tuomaskivioja/3-simple-python-projects/blob/master/pdf/pdfMerger.py) (PDF merger)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_image["Image editing"]
  node_images["Source images"]
  node_editor["Batch photo editor<br/>[photoEditor.py]"]
  node_edited["Edited images"]
end

subgraph group_pdf["PDF merging"]
  node_pdf_files["Current PDFs"]
  node_merger["PDF merger<br/>[pdfMerger.py]"]
  node_combined["Combined PDF"]
end

subgraph group_video["Video downloading"]
  node_downloader["YouTube downloader<br/>[ytDownloader.py]"]
  node_youtube["YouTube"]
end

node_user(("User"))

node_images -->|"reads"| node_editor
node_editor -->|"writes"| node_edited
node_user -->|"enters URL"| node_downloader
node_downloader -->|"requests video"| node_youtube
node_youtube -->|"provides stream"| node_downloader
node_downloader -->|"reports status"| node_user
node_pdf_files -->|"appends"| node_merger
node_merger -->|"writes"| node_combined

click node_editor "https://github.com/tuomaskivioja/3-simple-python-projects/blob/master/imageProcessor/photoEditor.py"
click node_merger "https://github.com/tuomaskivioja/3-simple-python-projects/blob/master/pdf/pdfMerger.py"
click node_downloader "https://github.com/tuomaskivioja/3-simple-python-projects/blob/master/ytDownloader.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_images,node_editor,node_edited,node_user toneBlue
class node_pdf_files,node_merger,node_combined toneAmber
class node_downloader,node_youtube toneMint
```

## Components

### Image editing

- **Source images**
- [Batch photo editor](https://github.com/tuomaskivioja/3-simple-python-projects/blob/master/imageProcessor/photoEditor.py): `imageProcessor/photoEditor.py`
- **Edited images**

### PDF merging

- **Current PDFs**
- [PDF merger](https://github.com/tuomaskivioja/3-simple-python-projects/blob/master/pdf/pdfMerger.py): `pdf/pdfMerger.py`
- **Combined PDF**

### Video downloading

- [YouTube downloader](https://github.com/tuomaskivioja/3-simple-python-projects/blob/master/ytDownloader.py): `ytDownloader.py`
- **YouTube**

### Other components

- **User**

## Connections

- Source images → Batch photo editor: reads (evidence: `imageProcessor/photoEditor.py`)
- Batch photo editor → Edited images: writes (evidence: `imageProcessor/photoEditor.py`)
- User → YouTube downloader: enters URL (evidence: `ytDownloader.py`)
- YouTube downloader → YouTube: requests video (evidence: `ytDownloader.py`)
- YouTube → YouTube downloader: provides stream (evidence: `ytDownloader.py`)
- YouTube downloader → User: reports status (evidence: `ytDownloader.py`)
- Current PDFs → PDF merger: appends (evidence: `pdf/pdfMerger.py`)
- PDF merger → Combined PDF: writes (evidence: `pdf/pdfMerger.py`)
