# dwyl/english-words architecture

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

- Interactive diagram: https://gitdiagram.com/dwyl/english-words
- Repository: https://github.com/dwyl/english-words

## Overview

This repository is primarily a distribution of English word-list data, with a small Python example for loading the alphabetic list into a set. The README distinguishes the complete list, an letters-only list, and a JSON dictionary; the example’s actual file read is visible in its source. The JSON conversion helper is omitted as ancillary tooling. The graph focuses on documented data formats and the sampled runtime behavior.

Main entry points: [`read_english_dictionary.py`](https://github.com/dwyl/english-words/blob/master/read_english_dictionary.py) (Word loader), [`words_alpha.txt`](https://github.com/dwyl/english-words/blob/master/words_alpha.txt) (Alphabetic words), [`words.txt`](https://github.com/dwyl/english-words/blob/master/words.txt) (All words), [`words_dictionary.json`](https://github.com/dwyl/english-words/blob/master/words_dictionary.json) (JSON dictionary)

## Diagram (Mermaid)

```mermaid
flowchart TD

node_app_user(("App developer"))
node_words_all["All words<br/>[words.txt]"]
node_words_alpha["Alphabetic words<br/>[words_alpha.txt]"]
node_word_dictionary["JSON dictionary"]
node_loader["Word loader"]
node_word_set["Loaded word set"]

node_app_user -->|"uses"| node_words_all
node_app_user -->|"uses"| node_words_alpha
node_app_user -->|"uses"| node_word_dictionary
node_app_user -->|"runs"| node_loader
node_loader -->|"reads"| node_words_alpha
node_loader -->|"builds"| node_word_set

click node_words_all "https://github.com/dwyl/english-words/blob/master/words.txt"
click node_words_alpha "https://github.com/dwyl/english-words/blob/master/words_alpha.txt"
click node_word_dictionary "https://github.com/dwyl/english-words/blob/master/words_dictionary.json"
click node_loader "https://github.com/dwyl/english-words/blob/master/read_english_dictionary.py"
click node_word_set "https://github.com/dwyl/english-words/blob/master/read_english_dictionary.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_app_user toneIndigo
class node_words_all,node_words_alpha,node_word_dictionary,node_loader,node_word_set toneTeal
```

## Components

### Other components

- **App developer**
- [All words](https://github.com/dwyl/english-words/blob/master/words.txt): `words.txt`
- [Alphabetic words](https://github.com/dwyl/english-words/blob/master/words_alpha.txt): `words_alpha.txt`
- [JSON dictionary](https://github.com/dwyl/english-words/blob/master/words_dictionary.json): `words_dictionary.json`
- [Word loader](https://github.com/dwyl/english-words/blob/master/read_english_dictionary.py): `read_english_dictionary.py`
- [Loaded word set](https://github.com/dwyl/english-words/blob/master/read_english_dictionary.py): `read_english_dictionary.py`

## Connections

- App developer → All words: uses (evidence: `README.md`)
- App developer → Alphabetic words: uses (evidence: `README.md`)
- App developer → JSON dictionary: uses (evidence: `README.md`)
- App developer → Word loader: runs (evidence: `read_english_dictionary.py`)
- Word loader → Alphabetic words: reads (evidence: `read_english_dictionary.py`)
- Word loader → Loaded word set: builds (evidence: `read_english_dictionary.py`)