# giftcharles/check-aris2-results architecture

> Architecture diagram of the GitHub repository giftcharles/check-aris2-results, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/giftcharles/check-aris2-results
- Repository: https://github.com/giftcharles/check-aris2-results

## Overview

This small Python script polls ARIS2 for a student’s results. Its main loop loads credentials, invokes browser-based navigation, and waits before retrying; navigation logs in, opens the results, and compares the table with a local snapshot. A detected change saves the full page. The README documents configurable polling intervals and headless mode. The graph reflects the single sampled runtime file; ChromeDriver and the ARIS site are external dependencies.

Main entry points: [`ARIS2Results.py`](https://github.com/giftcharles/check-aris2-results/blob/master/ARIS2Results.py) (ARIS navigation)

## Diagram (Mermaid)

```mermaid
flowchart TD

node_user(("Account holder"))
node_main["Polling loop<br/>[ARIS2Results.py]"]
node_credentials["Credentials"]
node_navigation["ARIS navigation<br/>[ARIS2Results.py]"]
node_browser["Chrome browser"]
node_aris["ARIS2 website"]
node_comparison["Table comparison<br/>[ARIS2Results.py]"]
node_snapshot[("Table snapshot<br/>[ARIS2Results.py]")]
node_fullpage["Full results HTML<br/>[ARIS2Results.py]"]

node_user -->|"starts checks"| node_main
node_main -->|"loads settings"| node_credentials
node_main -->|"calls"| node_navigation
node_navigation -->|"drives"| node_browser
node_browser -->|"visits"| node_aris
node_navigation -->|"checks table"| node_comparison
node_comparison -->|"reads or writes"| node_snapshot
node_navigation -->|"updates"| node_snapshot
node_navigation -->|"saves on change"| node_fullpage
node_main -->|"waits then retries"| node_main

click node_main "https://github.com/giftcharles/check-aris2-results/blob/master/ARIS2Results.py"
click node_navigation "https://github.com/giftcharles/check-aris2-results/blob/master/ARIS2Results.py"
click node_comparison "https://github.com/giftcharles/check-aris2-results/blob/master/ARIS2Results.py"
click node_snapshot "https://github.com/giftcharles/check-aris2-results/blob/master/ARIS2Results.py"
click node_fullpage "https://github.com/giftcharles/check-aris2-results/blob/master/ARIS2Results.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,node_credentials,node_aris toneIndigo
class node_main,node_navigation,node_comparison,node_fullpage toneTeal
class node_browser toneBlue
class node_snapshot toneAmber
```

## Components

### Other components

- **Account holder**
- [Polling loop](https://github.com/giftcharles/check-aris2-results/blob/master/ARIS2Results.py): `ARIS2Results.py`
- **Credentials**
- [ARIS navigation](https://github.com/giftcharles/check-aris2-results/blob/master/ARIS2Results.py): `ARIS2Results.py`
- **Chrome browser**
- **ARIS2 website**
- [Table comparison](https://github.com/giftcharles/check-aris2-results/blob/master/ARIS2Results.py): `ARIS2Results.py`
- [Table snapshot](https://github.com/giftcharles/check-aris2-results/blob/master/ARIS2Results.py): `ARIS2Results.py`
- [Full results HTML](https://github.com/giftcharles/check-aris2-results/blob/master/ARIS2Results.py): `ARIS2Results.py`

## Connections

- Account holder → Polling loop: starts checks (evidence: `README.md`)
- Polling loop → Credentials: loads settings (evidence: `ARIS2Results.py`)
- Polling loop → ARIS navigation: calls (evidence: `ARIS2Results.py`)
- ARIS navigation → Chrome browser: drives (evidence: `ARIS2Results.py`)
- Chrome browser → ARIS2 website: visits
- ARIS navigation → Table comparison: checks table (evidence: `ARIS2Results.py`)
- Table comparison → Table snapshot: reads or writes (evidence: `ARIS2Results.py`)
- ARIS navigation → Table snapshot: updates (evidence: `ARIS2Results.py`)
- ARIS navigation → Full results HTML: saves on change (evidence: `ARIS2Results.py`)
- Polling loop → Polling loop: waits then retries (evidence: `ARIS2Results.py`)
