# netest-jpg/expression architecture

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

## Overview

This Rust expression calculator accepts expressions in a command-line session, tokenizes and parses them into an AST, and provides evaluation, simplification, variable handling, and formatted output. The source also implements equation-solving and angle-aware trigonometry. The README is empty, so capability descriptions come from sampled source. Some CLI orchestration is omitted from the excerpts; accordingly, the graph shows only relationships supported by the available imports or source references.

Main entry points: [`src/main.rs`](https://github.com/netest-jpg/expression/blob/main/src/main.rs) (Expression session), [`src/parser.rs`](https://github.com/netest-jpg/expression/blob/main/src/parser.rs) (AST parser), [`src/simplification.rs`](https://github.com/netest-jpg/expression/blob/main/src/simplification.rs) (Expression simplifier), [`src/evaluation.rs`](https://github.com/netest-jpg/expression/blob/main/src/evaluation.rs) (Evaluation and solving)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_cli["Command-line interface"]
  node_app["Expression session<br/>[main.rs]"]
end

subgraph group_syntax["Expression syntax"]
  node_lexer["Tokenizer<br/>[lexer.rs]"]
  node_parser["AST parser<br/>[parser.rs]"]
end

subgraph group_math["Math operations"]
  node_evaluation["Evaluation and solving<br/>[evaluation.rs]"]
  node_simplification["Expression simplifier<br/>[simplification.rs]"]
  node_angles["Angle functions<br/>[angles.rs]"]
end

subgraph group_support["Formatting and state"]
  node_variables["Variable bank<br/>[variables.rs]"]
  node_format["Expression formatting<br/>[format.rs]"]
end

node_user(("CLI user"))

node_user -->|"enters expressions"| node_app
node_app -->|"uses tokenizer"| node_lexer
node_app -->|"uses parser"| node_parser
node_app -->|"uses simplifier"| node_simplification
node_app -->|"uses bindings"| node_variables
node_app -->|"uses formatting"| node_format
node_parser -->|"reads tokens"| node_lexer
node_evaluation -->|"reads AST"| node_parser
node_evaluation -->|"reads bindings"| node_variables
node_evaluation -->|"uses angle functions"| node_angles
node_evaluation -->|"references tokens"| node_lexer
node_simplification -->|"rewrites AST"| node_parser
node_simplification -->|"uses root helper"| node_evaluation
node_simplification -->|"uses angle functions"| node_angles
node_simplification -->|"references tokens"| node_lexer
node_variables -->|"walks AST"| node_parser
node_format -->|"formats AST"| node_parser
node_format -->|"formats tokens"| node_lexer

click node_app "https://github.com/netest-jpg/expression/blob/main/src/main.rs"
click node_lexer "https://github.com/netest-jpg/expression/blob/main/src/lexer.rs"
click node_parser "https://github.com/netest-jpg/expression/blob/main/src/parser.rs"
click node_evaluation "https://github.com/netest-jpg/expression/blob/main/src/evaluation.rs"
click node_simplification "https://github.com/netest-jpg/expression/blob/main/src/simplification.rs"
click node_angles "https://github.com/netest-jpg/expression/blob/main/src/angles.rs"
click node_variables "https://github.com/netest-jpg/expression/blob/main/src/variables.rs"
click node_format "https://github.com/netest-jpg/expression/blob/main/src/format.rs"

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,node_user toneBlue
class node_lexer,node_parser toneAmber
class node_evaluation,node_simplification,node_angles toneMint
class node_variables,node_format toneRose
```

## Components

### Command-line interface

- [Expression session](https://github.com/netest-jpg/expression/blob/main/src/main.rs): `src/main.rs`

### Expression syntax

- [Tokenizer](https://github.com/netest-jpg/expression/blob/main/src/lexer.rs): `src/lexer.rs`
- [AST parser](https://github.com/netest-jpg/expression/blob/main/src/parser.rs): `src/parser.rs`

### Math operations

- [Evaluation and solving](https://github.com/netest-jpg/expression/blob/main/src/evaluation.rs): `src/evaluation.rs`
- [Expression simplifier](https://github.com/netest-jpg/expression/blob/main/src/simplification.rs): `src/simplification.rs`
- [Angle functions](https://github.com/netest-jpg/expression/blob/main/src/angles.rs): `src/angles.rs`

### Formatting and state

- [Variable bank](https://github.com/netest-jpg/expression/blob/main/src/variables.rs): `src/variables.rs`
- [Expression formatting](https://github.com/netest-jpg/expression/blob/main/src/format.rs): `src/format.rs`

### Other components

- **CLI user**

## Connections

- CLI user → Expression session: enters expressions (evidence: `src/main.rs`)
- Expression session → Tokenizer: uses tokenizer (evidence: `src/main.rs`)
- Expression session → AST parser: uses parser (evidence: `src/main.rs`)
- Expression session → Expression simplifier: uses simplifier (evidence: `src/main.rs`)
- Expression session → Variable bank: uses bindings (evidence: `src/main.rs`)
- Expression session → Expression formatting: uses formatting (evidence: `src/main.rs`)
- AST parser → Tokenizer: reads tokens (evidence: `src/parser.rs`)
- Evaluation and solving → AST parser: reads AST (evidence: `src/evaluation.rs`)
- Evaluation and solving → Variable bank: reads bindings (evidence: `src/evaluation.rs`)
- Evaluation and solving → Angle functions: uses angle functions (evidence: `src/evaluation.rs`)
- Evaluation and solving → Tokenizer: references tokens (evidence: `src/evaluation.rs`)
- Expression simplifier → AST parser: rewrites AST (evidence: `src/simplification.rs`)
- Expression simplifier → Evaluation and solving: uses root helper (evidence: `src/simplification.rs`)
- Expression simplifier → Angle functions: uses angle functions (evidence: `src/simplification.rs`)
- Expression simplifier → Tokenizer: references tokens (evidence: `src/simplification.rs`)
- Variable bank → AST parser: walks AST (evidence: `src/variables.rs`)
- Expression formatting → AST parser: formats AST (evidence: `src/format.rs`)
- Expression formatting → Tokenizer: formats tokens (evidence: `src/format.rs`)
