# daniil-khanin/csvview architecture

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

- Interactive diagram: https://gitdiagram.com/daniil-khanin/csvview
- Repository: https://github.com/daniil-khanin/csvview

## Overview

csvview is a native terminal CSV viewer and editor. Its main workflow is to open a delimited or JSON-lines file, inspect and navigate its rows, then transform or analyze the data and optionally save or export results. The README also documents filters, sorting, formulas, statistics, pivots, charts, and file editing. The map includes these major capabilities; source excerpts are partial, so some links rely on README statements or SOURCE INDEX references rather than inspected call sites.

Main entry points: [`src/csvview.c`](https://github.com/daniil-khanin/csvview/blob/main/src/csvview.c) (Application loop), [`src/graph.c`](https://github.com/daniil-khanin/csvview/blob/main/src/graph.c) (Charts and plots), [`src/file_format.c`](https://github.com/daniil-khanin/csvview/blob/main/src/file_format.c) (Format drivers), [`src/table_edit.c`](https://github.com/daniil-khanin/csvview/blob/main/src/table_edit.c) (Table editing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Application"]
  node_main["Application loop<br/>[csvview.c]"]
end

subgraph group_data["Data handling"]
  node_format["Format drivers<br/>[file_format.c]"]
  node_json["NDJSON parsing<br/>[json_parse.c]"]
  node_mmap["Mapped file access<br/>[csv_mmap.c]"]
  node_edit["Table editing<br/>[table_edit.c]"]
  node_settings["Saved settings<br/>[column_format.c]"]
end

subgraph group_analysis["Analysis tools"]
  node_filter["Filtering<br/>[filtering.c]"]
  node_sort["Sorting<br/>[sorting.c]"]
  node_search["Search<br/>[search.c]"]
  node_formula["Computed columns<br/>[formula.c]"]
  node_stats["Column statistics<br/>[column_stats.c]"]
  node_pivot["Pivot tables<br/>[pivot.c]"]
  node_graph["Charts and plots<br/>[graph.c]"]
  node_svg["SVG export<br/>[graph_svg.c]"]
end

subgraph group_interface["Terminal experience"]
  node_table["Table rendering<br/>[ui_draw.c]"]
  node_cell_format["Cell formatting<br/>[column_format.c]"]
  node_theme["Themes<br/>[themes.c]"]
  node_help["Help display<br/>[help.c]"]
  node_bookmarks["Bookmarks<br/>[bookmarks.c]"]
end

node_user(("Terminal user"))
node_source_files["Input files"]
node_output_files["Saved or exported files"]

node_user -->|"opens and operates"| node_main
node_source_files -->|"opens"| node_main
node_main -->|"selects format"| node_format
node_format -->|"parses JSON rows"| node_json
node_main -->|"accesses rows"| node_mmap
node_main -->|"renders table"| node_table
node_table -->|"formats cells"| node_cell_format
node_main -->|"applies filters"| node_filter
node_main -->|"sorts rows"| node_sort
node_main -->|"searches rows"| node_search
node_main -->|"edits cells"| node_edit
node_main -->|"computes columns"| node_formula
node_main -->|"shows statistics"| node_stats
node_main -->|"opens pivots"| node_pivot
node_main -->|"draws charts"| node_graph
node_main -->|"exports graph"| node_svg
node_graph -->|"exports current view"| node_svg
node_pivot -->|"draws pivot chart"| node_graph
node_main -->|"loads and saves"| node_settings
node_settings -->|"persists settings"| node_output_files
node_main -->|"loads theme"| node_theme
node_main -->|"shows help"| node_help
node_main -->|"manages bookmarks"| node_bookmarks
node_edit -->|"saves edits"| node_output_files

click node_main "https://github.com/daniil-khanin/csvview/blob/main/src/csvview.c"
click node_format "https://github.com/daniil-khanin/csvview/blob/main/src/file_format.c"
click node_json "https://github.com/daniil-khanin/csvview/blob/main/src/json_parse.c"
click node_mmap "https://github.com/daniil-khanin/csvview/blob/main/src/csv_mmap.c"
click node_table "https://github.com/daniil-khanin/csvview/blob/main/src/ui_draw.c"
click node_cell_format "https://github.com/daniil-khanin/csvview/blob/main/src/column_format.c"
click node_filter "https://github.com/daniil-khanin/csvview/blob/main/src/filtering.c"
click node_sort "https://github.com/daniil-khanin/csvview/blob/main/src/sorting.c"
click node_search "https://github.com/daniil-khanin/csvview/blob/main/src/search.c"
click node_edit "https://github.com/daniil-khanin/csvview/blob/main/src/table_edit.c"
click node_formula "https://github.com/daniil-khanin/csvview/blob/main/src/formula.c"
click node_stats "https://github.com/daniil-khanin/csvview/blob/main/src/column_stats.c"
click node_pivot "https://github.com/daniil-khanin/csvview/blob/main/src/pivot.c"
click node_graph "https://github.com/daniil-khanin/csvview/blob/main/src/graph.c"
click node_svg "https://github.com/daniil-khanin/csvview/blob/main/src/graph_svg.c"
click node_settings "https://github.com/daniil-khanin/csvview/blob/main/src/column_format.c"
click node_theme "https://github.com/daniil-khanin/csvview/blob/main/src/themes.c"
click node_help "https://github.com/daniil-khanin/csvview/blob/main/src/help.c"
click node_bookmarks "https://github.com/daniil-khanin/csvview/blob/main/src/bookmarks.c"

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_main,node_user toneBlue
class node_format,node_json,node_mmap,node_edit,node_settings toneAmber
class node_filter,node_sort,node_search,node_formula,node_stats,node_pivot,node_graph,node_svg toneMint
class node_table,node_cell_format,node_theme,node_help,node_bookmarks toneRose
class node_source_files,node_output_files toneIndigo
```

## Components

### Application

- [Application loop](https://github.com/daniil-khanin/csvview/blob/main/src/csvview.c): `src/csvview.c`

### Data handling

- [Format drivers](https://github.com/daniil-khanin/csvview/blob/main/src/file_format.c): `src/file_format.c`
- [NDJSON parsing](https://github.com/daniil-khanin/csvview/blob/main/src/json_parse.c): `src/json_parse.c`
- [Mapped file access](https://github.com/daniil-khanin/csvview/blob/main/src/csv_mmap.c): `src/csv_mmap.c`
- [Table editing](https://github.com/daniil-khanin/csvview/blob/main/src/table_edit.c): `src/table_edit.c`
- [Saved settings](https://github.com/daniil-khanin/csvview/blob/main/src/column_format.c): `src/column_format.c`

### Analysis tools

- [Filtering](https://github.com/daniil-khanin/csvview/blob/main/src/filtering.c): `src/filtering.c`
- [Sorting](https://github.com/daniil-khanin/csvview/blob/main/src/sorting.c): `src/sorting.c`
- [Search](https://github.com/daniil-khanin/csvview/blob/main/src/search.c): `src/search.c`
- [Computed columns](https://github.com/daniil-khanin/csvview/blob/main/src/formula.c): `src/formula.c`
- [Column statistics](https://github.com/daniil-khanin/csvview/blob/main/src/column_stats.c): `src/column_stats.c`
- [Pivot tables](https://github.com/daniil-khanin/csvview/blob/main/src/pivot.c): `src/pivot.c`
- [Charts and plots](https://github.com/daniil-khanin/csvview/blob/main/src/graph.c): `src/graph.c`
- [SVG export](https://github.com/daniil-khanin/csvview/blob/main/src/graph_svg.c): `src/graph_svg.c`

### Terminal experience

- [Table rendering](https://github.com/daniil-khanin/csvview/blob/main/src/ui_draw.c): `src/ui_draw.c`
- [Cell formatting](https://github.com/daniil-khanin/csvview/blob/main/src/column_format.c): `src/column_format.c`
- [Themes](https://github.com/daniil-khanin/csvview/blob/main/src/themes.c): `src/themes.c`
- [Help display](https://github.com/daniil-khanin/csvview/blob/main/src/help.c): `src/help.c`
- [Bookmarks](https://github.com/daniil-khanin/csvview/blob/main/src/bookmarks.c): `src/bookmarks.c`

### Other components

- **Terminal user**
- **Input files**
- **Saved or exported files**

## Connections

- Terminal user → Application loop: opens and operates
- Input files → Application loop: opens
- Application loop → Format drivers: selects format (evidence: `src/csvview.c`)
- Format drivers → NDJSON parsing: parses JSON rows
- Application loop → Mapped file access: accesses rows (evidence: `src/csvview.c`)
- Application loop → Table rendering: renders table (evidence: `src/csvview.c`)
- Table rendering → Cell formatting: formats cells (evidence: `src/ui_draw.c`)
- Application loop → Filtering: applies filters (evidence: `src/csvview.c`)
- Application loop → Sorting: sorts rows (evidence: `src/csvview.c`)
- Application loop → Search: searches rows (evidence: `src/csvview.c`)
- Application loop → Table editing: edits cells (evidence: `src/csvview.c`)
- Application loop → Computed columns: computes columns (evidence: `src/csvview.c`)
- Application loop → Column statistics: shows statistics (evidence: `src/csvview.c`)
- Application loop → Pivot tables: opens pivots (evidence: `src/csvview.c`)
- Application loop → Charts and plots: draws charts (evidence: `src/csvview.c`)
- Application loop → SVG export: exports graph
- Charts and plots → SVG export: exports current view
- Pivot tables → Charts and plots: draws pivot chart
- Application loop → Saved settings: loads and saves (evidence: `src/csvview.c`)
- Saved settings → Saved or exported files: persists settings
- Application loop → Themes: loads theme (evidence: `src/csvview.c`)
- Application loop → Help display: shows help (evidence: `src/csvview.c`)
- Application loop → Bookmarks: manages bookmarks (evidence: `src/bookmarks.c`)
- Table editing → Saved or exported files: saves edits
