# perry280/calculator architecture

> Architecture diagram of the GitHub repository perry280/calculator, 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/perry280/calculator
- Repository: https://github.com/perry280/calculator

## Overview

This is a command-line arithmetic expression calculator. The user supplies an expression as command-line arguments; the CLI combines multiple arguments, tokenizes the expression, parses and evaluates the token stream, then prints the input and result or a location-aware error. The C lexer and recursive-descent parser implement the main runtime path; utility code formats output. The tree includes `parsing.py`, which computes grammar sets and an LL(1) table, but no evidence shows it participates in calculator execution. The README is empty, so capabilities and connections are limited to the supplied source excerpts and index.

Main entry points: [`calculator.c`](https://github.com/perry280/calculator/blob/main/calculator.c) (CLI entry), [`lexer.c`](https://github.com/perry280/calculator/blob/main/lexer.c) (Tokenizer), [`parser.c`](https://github.com/perry280/calculator/blob/main/parser.c) (Expression parser), [`utils.h`](https://github.com/perry280/calculator/blob/main/utils.h) (Output API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Calculator runtime"]
  node_cli["CLI entry<br/>[calculator.c]"]
  node_tokenizer["Tokenizer<br/>[lexer.c]"]
  node_token_stream["Token stream<br/>[lexer.h]"]
  node_parser["Expression parser<br/>[parser.c]"]
  node_grammar_api["Parser grammar API<br/>[parser.h]"]
  node_token_types["Token and error types<br/>[types.h]"]
  node_output["Output formatting<br/>[utils.c]"]
  node_output_api["Output API<br/>[utils.h]"]
end

subgraph group_grammar["Grammar analysis"]
  node_grammar_tool["Grammar analysis<br/>[parsing.py]"]
end

node_user(("CLI user"))

node_user -->|"provides expression"| node_cli
node_cli -->|"tokenizes input"| node_tokenizer
node_cli -->|"parses tokens"| node_parser
node_cli -->|"prints result or error"| node_output
node_tokenizer -->|"produces tokens"| node_token_stream
node_parser -->|"reads tokens"| node_token_stream
node_cli -->|"calls formatting API"| node_output_api
node_output_api -->|"formats output"| node_output

click node_cli "https://github.com/perry280/calculator/blob/main/calculator.c"
click node_tokenizer "https://github.com/perry280/calculator/blob/main/lexer.c"
click node_token_stream "https://github.com/perry280/calculator/blob/main/lexer.h"
click node_parser "https://github.com/perry280/calculator/blob/main/parser.c"
click node_grammar_api "https://github.com/perry280/calculator/blob/main/parser.h"
click node_token_types "https://github.com/perry280/calculator/blob/main/types.h"
click node_output "https://github.com/perry280/calculator/blob/main/utils.c"
click node_output_api "https://github.com/perry280/calculator/blob/main/utils.h"
click node_grammar_tool "https://github.com/perry280/calculator/blob/main/parsing.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_cli,node_tokenizer,node_token_stream,node_parser,node_grammar_api,node_token_types,node_output,node_output_api,node_user toneBlue
class node_grammar_tool toneAmber
```

## Components

### Calculator runtime

- [CLI entry](https://github.com/perry280/calculator/blob/main/calculator.c): `calculator.c`
- [Tokenizer](https://github.com/perry280/calculator/blob/main/lexer.c): `lexer.c`
- [Token stream](https://github.com/perry280/calculator/blob/main/lexer.h): `lexer.h`
- [Expression parser](https://github.com/perry280/calculator/blob/main/parser.c): `parser.c`
- [Parser grammar API](https://github.com/perry280/calculator/blob/main/parser.h): `parser.h`
- [Token and error types](https://github.com/perry280/calculator/blob/main/types.h): `types.h`
- [Output formatting](https://github.com/perry280/calculator/blob/main/utils.c): `utils.c`
- [Output API](https://github.com/perry280/calculator/blob/main/utils.h): `utils.h`

### Grammar analysis

- [Grammar analysis](https://github.com/perry280/calculator/blob/main/parsing.py): `parsing.py`

### Other components

- **CLI user**

## Connections

- CLI user → CLI entry: provides expression (evidence: `calculator.c`)
- CLI entry → Tokenizer: tokenizes input (evidence: `calculator.c`)
- CLI entry → Expression parser: parses tokens (evidence: `calculator.c`)
- CLI entry → Output formatting: prints result or error (evidence: `calculator.c`)
- Tokenizer → Token stream: produces tokens (evidence: `lexer.c`)
- Expression parser → Token stream: reads tokens (evidence: `parser.c`)
- CLI entry → Output API: calls formatting API (evidence: `calculator.c`)
- Output API → Output formatting: formats output (evidence: `utils.h`)
