# misarobison/pacman-python architecture

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

- Interactive diagram: https://gitdiagram.com/misarobison/pacman-python
- Repository: https://github.com/misarobison/pacman-python

## Overview

This is a small Pygame Pac-Man game. The visible workflow is: the game entry point generates a maze, creates the game engine and ghosts, accepts player movement, updates Pac-Man and pellets, and renders the board and characters. Maze generation includes a reachability check; the engine also provides ghost-move selection, though the shown main loop does not update ghost positions. The graph follows the sampled entry point and modules; no README was provided, and src/view.py is empty.

Main entry points: [`main.py`](https://github.com/misarobison/pacman-python/blob/master/main.py) (Game entry), [`src/engine.py`](https://github.com/misarobison/pacman-python/blob/master/src/engine.py) (Game engine), [`src/constants.py`](https://github.com/misarobison/pacman-python/blob/master/src/constants.py) (Game constants), [`src/level.py`](https://github.com/misarobison/pacman-python/blob/master/src/level.py) (Level generation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_gameplay["Game loop"]
  node_entry["Game entry<br/>[main.py]"]
  node_constants["Game constants<br/>[constants.py]"]
end

subgraph group_world["Maze and rules"]
  node_level["Level generation<br/>[level.py]"]
  node_engine["Game engine<br/>[engine.py]"]
end

subgraph group_characters["Characters"]
  node_pacman["Pac-Man state<br/>[pacman.py]"]
  node_ghost["Ghost state and AI<br/>[ghost.py]"]
end

node_player(("Player"))
node_pygame["Pygame"]

node_player -->|"provides input"| node_entry
node_entry -->|"uses events and display"| node_pygame
node_entry -->|"generates level"| node_level
node_level -->|"returns grid and starts"| node_entry
node_entry -->|"creates engine"| node_engine
node_entry -->|"creates ghosts"| node_ghost
node_entry -->|"moves Pac-Man"| node_engine
node_engine -->|"creates and moves"| node_pacman
node_entry -->|"renders game state"| node_pygame
node_ghost -->|"requests move choice"| node_engine
node_engine -->|"reads tile and move values"| node_constants
node_level -->|"reads grid values"| node_constants
node_ghost -->|"reads movement values"| node_constants
node_entry -->|"reads display and colors"| node_constants

click node_entry "https://github.com/misarobison/pacman-python/blob/master/main.py"
click node_constants "https://github.com/misarobison/pacman-python/blob/master/src/constants.py"
click node_level "https://github.com/misarobison/pacman-python/blob/master/src/level.py"
click node_engine "https://github.com/misarobison/pacman-python/blob/master/src/engine.py"
click node_pacman "https://github.com/misarobison/pacman-python/blob/master/src/pacman.py"
click node_ghost "https://github.com/misarobison/pacman-python/blob/master/src/ghost.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_entry,node_constants toneBlue
class node_level,node_engine toneAmber
class node_pacman,node_ghost toneMint
class node_player,node_pygame toneIndigo
```

## Components

### Game loop

- [Game entry](https://github.com/misarobison/pacman-python/blob/master/main.py): `main.py`
- [Game constants](https://github.com/misarobison/pacman-python/blob/master/src/constants.py): `src/constants.py`

### Maze and rules

- [Level generation](https://github.com/misarobison/pacman-python/blob/master/src/level.py): `src/level.py`
- [Game engine](https://github.com/misarobison/pacman-python/blob/master/src/engine.py): `src/engine.py`

### Characters

- [Pac-Man state](https://github.com/misarobison/pacman-python/blob/master/src/pacman.py): `src/pacman.py`
- [Ghost state and AI](https://github.com/misarobison/pacman-python/blob/master/src/ghost.py): `src/ghost.py`

### Other components

- **Player**
- **Pygame**

## Connections

- Player → Game entry: provides input
- Game entry → Pygame: uses events and display
- Game entry → Level generation: generates level
- Level generation → Game entry: returns grid and starts
- Game entry → Game engine: creates engine
- Game entry → Ghost state and AI: creates ghosts
- Game entry → Game engine: moves Pac-Man
- Game engine → Pac-Man state: creates and moves
- Game entry → Pygame: renders game state
- Ghost state and AI → Game engine: requests move choice
- Game engine → Game constants: reads tile and move values
- Level generation → Game constants: reads grid values
- Ghost state and AI → Game constants: reads movement values
- Game entry → Game constants: reads display and colors