# kaw393939/is218-statistics-practice architecture

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

- Interactive diagram: https://gitdiagram.com/kaw393939/is218-statistics-practice
- Repository: https://github.com/kaw393939/is218-statistics-practice

## Overview

This is a command-line measurement-calibration calculator. A user enters a typed request or CSV request; the CLI parses it, the factory constructs a deferred Calculation, and a command asks the session to execute it. Successful results are saved and can be listed, recalled, or cleared. The map also includes arithmetic/statistical operations and shared numeric validation. The README documents intended adjustment, span, and CSV behavior; sampled code shows some of those adaptations are unfinished, so documented routes are distinguished from implemented behavior.

Main entry points: [`calculator/cli.py`](https://github.com/kaw393939/is218-statistics-practice/blob/main/calculator/cli.py) (CLI Parser Loop), [`calculator/calculation.py`](https://github.com/kaw393939/is218-statistics-practice/blob/main/calculator/calculation.py) (Deferred Calculation), [`calculator/factory.py`](https://github.com/kaw393939/is218-statistics-practice/blob/main/calculator/factory.py) (Calculation Factory), [`calculator/session.py`](https://github.com/kaw393939/is218-statistics-practice/blob/main/calculator/session.py) (Calculator Session)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["User Interface"]
  node_entrypoint["Module Entrypoint<br/>[__main__.py]"]
  node_cli["CLI Parser Loop<br/>[cli.py]"]
end

subgraph group_application["Request Handling"]
  node_commands["Command Actions<br/>[commands.py]"]
  node_csvinput["CSV Reader<br/>[inputs.py]"]
  node_factory["Calculation Factory<br/>[factory.py]"]
end

subgraph group_domain["Calculation Domain"]
  node_calculation["Deferred Calculation<br/>[calculation.py]"]
  node_operations["Math Operations<br/>[operations.py]"]
  node_statistics["Statistical Functions<br/>[statistics.py]"]
  node_validation["Numeric Validation<br/>[validation.py]"]
end

subgraph group_state["History State"]
  node_session["Calculator Session<br/>[session.py]"]
  node_history[("Saved History<br/>[history.py]")]
end

node_user(("Calculator User"))

node_user -->|"enters requests"| node_cli
node_entrypoint -->|"starts loop"| node_cli
node_cli -->|"dispatches actions"| node_commands
node_cli -->|"builds calculations"| node_factory
node_cli -->|"reads CSV"| node_csvinput
node_cli -->|"creates session"| node_session
node_commands -->|"requests execution"| node_session
node_commands -->|"formats saved entries"| node_history
node_factory -->|"constructs"| node_calculation
node_factory -->|"selects callable"| node_operations
node_factory -->|"converts options"| node_validation
node_calculation -->|"converts operands"| node_validation
node_calculation -->|"dispatches execution"| node_operations
node_operations -->|"uses statistics"| node_statistics
node_statistics -->|"converts readings"| node_validation
node_session -->|"executes once"| node_calculation
node_session -->|"records result"| node_history
node_history -->|"stores request"| node_calculation

click node_entrypoint "https://github.com/kaw393939/is218-statistics-practice/blob/main/calculator/__main__.py"
click node_cli "https://github.com/kaw393939/is218-statistics-practice/blob/main/calculator/cli.py"
click node_commands "https://github.com/kaw393939/is218-statistics-practice/blob/main/calculator/commands.py"
click node_csvinput "https://github.com/kaw393939/is218-statistics-practice/blob/main/calculator/inputs.py"
click node_factory "https://github.com/kaw393939/is218-statistics-practice/blob/main/calculator/factory.py"
click node_calculation "https://github.com/kaw393939/is218-statistics-practice/blob/main/calculator/calculation.py"
click node_operations "https://github.com/kaw393939/is218-statistics-practice/blob/main/calculator/operations.py"
click node_statistics "https://github.com/kaw393939/is218-statistics-practice/blob/main/calculator/statistics.py"
click node_validation "https://github.com/kaw393939/is218-statistics-practice/blob/main/calculator/validation.py"
click node_session "https://github.com/kaw393939/is218-statistics-practice/blob/main/calculator/session.py"
click node_history "https://github.com/kaw393939/is218-statistics-practice/blob/main/calculator/history.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_entrypoint,node_cli,node_user toneBlue
class node_commands,node_csvinput,node_factory toneAmber
class node_calculation,node_operations,node_statistics,node_validation toneMint
class node_session,node_history toneRose
```

## Components

### User Interface

- [Module Entrypoint](https://github.com/kaw393939/is218-statistics-practice/blob/main/calculator/__main__.py): `calculator/__main__.py`
- [CLI Parser Loop](https://github.com/kaw393939/is218-statistics-practice/blob/main/calculator/cli.py): `calculator/cli.py`

### Request Handling

- [Command Actions](https://github.com/kaw393939/is218-statistics-practice/blob/main/calculator/commands.py): `calculator/commands.py`
- [CSV Reader](https://github.com/kaw393939/is218-statistics-practice/blob/main/calculator/inputs.py): `calculator/inputs.py`
- [Calculation Factory](https://github.com/kaw393939/is218-statistics-practice/blob/main/calculator/factory.py): `calculator/factory.py`

### Calculation Domain

- [Deferred Calculation](https://github.com/kaw393939/is218-statistics-practice/blob/main/calculator/calculation.py): `calculator/calculation.py`
- [Math Operations](https://github.com/kaw393939/is218-statistics-practice/blob/main/calculator/operations.py): `calculator/operations.py`
- [Statistical Functions](https://github.com/kaw393939/is218-statistics-practice/blob/main/calculator/statistics.py): `calculator/statistics.py`
- [Numeric Validation](https://github.com/kaw393939/is218-statistics-practice/blob/main/calculator/validation.py): `calculator/validation.py`

### History State

- [Calculator Session](https://github.com/kaw393939/is218-statistics-practice/blob/main/calculator/session.py): `calculator/session.py`
- [Saved History](https://github.com/kaw393939/is218-statistics-practice/blob/main/calculator/history.py): `calculator/history.py`

### Other components

- **Calculator User**

## Connections

- Calculator User → CLI Parser Loop: enters requests (evidence: `README.md`)
- Module Entrypoint → CLI Parser Loop: starts loop (evidence: `calculator/__main__.py`)
- CLI Parser Loop → Command Actions: dispatches actions (evidence: `calculator/cli.py`)
- CLI Parser Loop → Calculation Factory: builds calculations (evidence: `calculator/cli.py`)
- CLI Parser Loop → CSV Reader: reads CSV (evidence: `calculator/cli.py`)
- CLI Parser Loop → Calculator Session: creates session (evidence: `calculator/cli.py`)
- Command Actions → Calculator Session: requests execution (evidence: `calculator/commands.py`)
- Command Actions → Saved History: formats saved entries (evidence: `README.md`)
- Calculation Factory → Deferred Calculation: constructs (evidence: `calculator/factory.py`)
- Calculation Factory → Math Operations: selects callable (evidence: `calculator/factory.py`)
- Calculation Factory → Numeric Validation: converts options (evidence: `calculator/factory.py`)
- Deferred Calculation → Numeric Validation: converts operands (evidence: `calculator/calculation.py`)
- Deferred Calculation → Math Operations: dispatches execution (evidence: `calculator/calculation.py`)
- Math Operations → Statistical Functions: uses statistics (evidence: `calculator/operations.py`)
- Statistical Functions → Numeric Validation: converts readings (evidence: `calculator/statistics.py`)
- Calculator Session → Deferred Calculation: executes once (evidence: `calculator/session.py`)
- Calculator Session → Saved History: records result (evidence: `README.md`)
- Saved History → Deferred Calculation: stores request (evidence: `calculator/history.py`)
