# baptchau/python-password architecture

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

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

## Overview

This is a small command-line password generator. The user starts `main.py`, supplies a requested length, and receives a generated password if the length is at least 12 and the password is not in the exclusion list. The implementation is sampled; the README documents how to run it, but no broader capabilities. The exclusion-list file is shown as input data, not a database.

Main entry points: [`main.py`](https://github.com/baptchau/python-password/blob/master/main.py) (CLI workflow), [`helpers/helpers.py`](https://github.com/baptchau/python-password/blob/master/helpers/helpers.py) (Password generation), [`helpers/dictionary.yaml`](https://github.com/baptchau/python-password/blob/master/helpers/dictionary.yaml) (Exclusion list)

## Diagram (Mermaid)

```mermaid
flowchart TD

node_user(("User"))
node_cli["CLI workflow<br/>[main.py]"]
node_length_input["Length input<br/>[helpers.py]"]
node_length_check["Length validation<br/>[helpers.py]"]
node_password_generation["Password generation<br/>[helpers.py]"]
node_exclusion_check["Exclusion check<br/>[helpers.py]"]
node_exclusion_list["Exclusion list<br/>[dictionary.yaml]"]

node_user -->|"runs script"| node_cli
node_cli -->|"requests length"| node_length_input
node_cli -->|"validates length"| node_length_check
node_cli -->|"requests password"| node_password_generation
node_password_generation -->|"checks password"| node_exclusion_check
node_exclusion_check -->|"reads exclusions"| node_exclusion_list
node_cli -->|"prints password"| node_user

click node_cli "https://github.com/baptchau/python-password/blob/master/main.py"
click node_length_input "https://github.com/baptchau/python-password/blob/master/helpers/helpers.py"
click node_length_check "https://github.com/baptchau/python-password/blob/master/helpers/helpers.py"
click node_password_generation "https://github.com/baptchau/python-password/blob/master/helpers/helpers.py"
click node_exclusion_check "https://github.com/baptchau/python-password/blob/master/helpers/helpers.py"
click node_exclusion_list "https://github.com/baptchau/python-password/blob/master/helpers/dictionary.yaml"

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_length_input,node_length_check,node_password_generation,node_exclusion_check,node_exclusion_list toneTeal
```

## Components

### Other components

- **User**
- [CLI workflow](https://github.com/baptchau/python-password/blob/master/main.py): `main.py`
- [Length input](https://github.com/baptchau/python-password/blob/master/helpers/helpers.py): `helpers/helpers.py`
- [Length validation](https://github.com/baptchau/python-password/blob/master/helpers/helpers.py): `helpers/helpers.py`
- [Password generation](https://github.com/baptchau/python-password/blob/master/helpers/helpers.py): `helpers/helpers.py`
- [Exclusion check](https://github.com/baptchau/python-password/blob/master/helpers/helpers.py): `helpers/helpers.py`
- [Exclusion list](https://github.com/baptchau/python-password/blob/master/helpers/dictionary.yaml): `helpers/dictionary.yaml`

## Connections

- User → CLI workflow: runs script (evidence: `readme.md`)
- CLI workflow → Length input: requests length (evidence: `main.py`)
- CLI workflow → Length validation: validates length (evidence: `main.py`)
- CLI workflow → Password generation: requests password (evidence: `main.py`)
- Password generation → Exclusion check: checks password (evidence: `helpers/helpers.py`)
- Exclusion check → Exclusion list: reads exclusions (evidence: `helpers/helpers.py`)
- CLI workflow → User: prints password (evidence: `main.py`)
