# jhon287/my-password-generator architecture

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

- Interactive diagram: https://gitdiagram.com/jhon287/my-password-generator
- Repository: https://github.com/jhon287/my-password-generator

## Overview

This is a small command-line password utility. The user supplies a password interactively or through stdin, or the program generates one; selected outputs can display it, hash it, or copy it to the clipboard. The graph separates those runtime responsibilities while noting that the parser and password operations share `src/utils.py`.

Main entry points: [`src/main.py`](https://github.com/jhon287/my-password-generator/blob/main/src/main.py) (CLI workflow), [`src/utils.py`](https://github.com/jhon287/my-password-generator/blob/main/src/utils.py) (Password generator), [`src/config.py`](https://github.com/jhon287/my-password-generator/blob/main/src/config.py) (Password defaults)

## Diagram (Mermaid)

```mermaid
flowchart TD

node_user(("User"))
node_cli["CLI workflow<br/>[main.py]"]
node_parser["Argument parser<br/>[utils.py]"]
node_input["Password input<br/>[utils.py]"]
node_generator["Password generator<br/>[utils.py]"]
node_config["Password defaults<br/>[config.py]"]
node_hashing["Password hashing<br/>[utils.py]"]
node_display["Result display<br/>[utils.py]"]
node_clipboard["Clipboard"]

node_user -->|"runs"| node_cli
node_cli -->|"parses options"| node_parser
node_cli -->|"reads password"| node_input
node_cli -->|"generates password"| node_generator
node_config -->|"provides defaults"| node_generator
node_cli -->|"hashes password"| node_hashing
node_cli -->|"shows results"| node_display
node_cli -->|"copies password"| node_clipboard

click node_cli "https://github.com/jhon287/my-password-generator/blob/main/src/main.py"
click node_parser "https://github.com/jhon287/my-password-generator/blob/main/src/utils.py"
click node_input "https://github.com/jhon287/my-password-generator/blob/main/src/utils.py"
click node_generator "https://github.com/jhon287/my-password-generator/blob/main/src/utils.py"
click node_config "https://github.com/jhon287/my-password-generator/blob/main/src/config.py"
click node_hashing "https://github.com/jhon287/my-password-generator/blob/main/src/utils.py"
click node_display "https://github.com/jhon287/my-password-generator/blob/main/src/utils.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_user toneBlue
class node_cli,node_parser,node_input,node_generator,node_config,node_hashing,node_display toneTeal
class node_clipboard toneIndigo
```

## Components

### Other components

- **User**
- [CLI workflow](https://github.com/jhon287/my-password-generator/blob/main/src/main.py): `src/main.py`
- [Argument parser](https://github.com/jhon287/my-password-generator/blob/main/src/utils.py): `src/utils.py`
- [Password input](https://github.com/jhon287/my-password-generator/blob/main/src/utils.py): `src/utils.py`
- [Password generator](https://github.com/jhon287/my-password-generator/blob/main/src/utils.py): `src/utils.py`
- [Password defaults](https://github.com/jhon287/my-password-generator/blob/main/src/config.py): `src/config.py`
- [Password hashing](https://github.com/jhon287/my-password-generator/blob/main/src/utils.py): `src/utils.py`
- [Result display](https://github.com/jhon287/my-password-generator/blob/main/src/utils.py): `src/utils.py`
- **Clipboard**

## Connections

- User → CLI workflow: runs (evidence: `README.md`)
- CLI workflow → Argument parser: parses options (evidence: `src/main.py`)
- CLI workflow → Password input: reads password (evidence: `src/main.py`)
- CLI workflow → Password generator: generates password (evidence: `src/main.py`)
- Password defaults → Password generator: provides defaults (evidence: `src/utils.py`)
- CLI workflow → Password hashing: hashes password (evidence: `src/main.py`)
- CLI workflow → Result display: shows results (evidence: `src/main.py`)
- CLI workflow → Clipboard: copies password (evidence: `src/main.py`)
