# kzarzour/password-generator architecture

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

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

## Overview

This small Java console application gathers password preferences, generates and displays a password, and checks entered passwords against character-category and length criteria. The README also describes console-based security guidance. Source excerpts were unavailable, so the component mapping follows the documented behavior and filenames; internal call details are not independently verified.

Main entry points: [`Password Generator/src/Main.java`](https://github.com/kzarzour/password-generator/blob/master/Password%20Generator/src/Main.java) (Console interface), [`Password Generator/src/Generator.java`](https://github.com/kzarzour/password-generator/blob/master/Password%20Generator/src/Generator.java) (Password generator), [`Password Generator/src/Password.java`](https://github.com/kzarzour/password-generator/blob/master/Password%20Generator/src/Password.java) (Strength checker), [`Password Generator/src/Alphabet.java`](https://github.com/kzarzour/password-generator/blob/master/Password%20Generator/src/Alphabet.java) (Character alphabet)

## Diagram (Mermaid)

```mermaid
flowchart TD

node_user(("Console user"))
node_main["Console interface<br/>[Main.java]"]
node_generator["Password generator<br/>[Generator.java]"]
node_alphabet["Character alphabet<br/>[Alphabet.java]"]
node_password["Strength checker<br/>[Password.java]"]

node_user -->|"enters choices"| node_main
node_main -->|"requests generation"| node_generator
node_generator -->|"selects characters"| node_alphabet
node_generator -->|"returns password"| node_main
node_main -->|"displays password"| node_user
node_main -->|"checks password"| node_password
node_password -->|"returns strength"| node_main
node_main -->|"displays guidance"| node_user

click node_main "https://github.com/kzarzour/password-generator/blob/master/Password%20Generator/src/Main.java"
click node_generator "https://github.com/kzarzour/password-generator/blob/master/Password%20Generator/src/Generator.java"
click node_alphabet "https://github.com/kzarzour/password-generator/blob/master/Password%20Generator/src/Alphabet.java"
click node_password "https://github.com/kzarzour/password-generator/blob/master/Password%20Generator/src/Password.java"

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_main,node_generator,node_alphabet,node_password toneTeal
```

## Components

### Other components

- **Console user**
- [Console interface](https://github.com/kzarzour/password-generator/blob/master/Password%20Generator/src/Main.java): `Password Generator/src/Main.java`
- [Password generator](https://github.com/kzarzour/password-generator/blob/master/Password%20Generator/src/Generator.java): `Password Generator/src/Generator.java`
- [Character alphabet](https://github.com/kzarzour/password-generator/blob/master/Password%20Generator/src/Alphabet.java): `Password Generator/src/Alphabet.java`
- [Strength checker](https://github.com/kzarzour/password-generator/blob/master/Password%20Generator/src/Password.java): `Password Generator/src/Password.java`

## Connections

- Console user → Console interface: enters choices
- Console interface → Password generator: requests generation
- Password generator → Character alphabet: selects characters
- Password generator → Console interface: returns password
- Console interface → Console user: displays password
- Console interface → Strength checker: checks password
- Strength checker → Console interface: returns strength
- Console interface → Console user: displays guidance
