# eza-community/eza architecture

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

- Interactive diagram: https://gitdiagram.com/eza-community/eza
- Repository: https://github.com/eza-community/eza

## Overview

eza is a cross-platform `ls` replacement. The main workflow parses command-line options, obtains and filters filesystem entries, then renders them in a selected view. Long views add metadata such as permissions, timestamps, Git status, mounts, and extended attributes; a separate code-summary view counts source lines. The README documents these capabilities, while the source index and excerpts support only some internal call relationships, so unsampled subsystem links are omitted rather than inferred.

Main entry points: [`src/main.rs`](https://github.com/eza-community/eza/blob/main/src/main.rs) (CLI entry), [`src/fs/file.rs`](https://github.com/eza-community/eza/blob/main/src/fs/file.rs) (File metadata), [`src/options/view.rs`](https://github.com/eza-community/eza/blob/main/src/options/view.rs) (View selection), [`src/output/details.rs`](https://github.com/eza-community/eza/blob/main/src/output/details.rs) (Details view)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_cli["Command line"]
  node_entry["CLI entry<br/>[main.rs]"]
  node_options["Option handling<br/>[mod.rs]"]
  node_parser["Argument parser<br/>[parser.rs]"]
  node_stdin["Stdin paths<br/>[stdin.rs]"]
end

subgraph group_filesystem["Filesystem data"]
  node_directory["Directory entries<br/>[dir.rs]"]
  node_file["File metadata<br/>[file.rs]"]
  node_filter["Sort and filter<br/>[filter.rs]"]
  node_fields["Metadata fields<br/>[fields.rs]"]
end

subgraph group_features["Metadata features"]
  node_git["Git status<br/>[git.rs]"]
  node_xattrs["Extended attributes<br/>[xattr.rs]"]
  node_mounts["Mount details<br/>[mod.rs]"]
  node_recursive["Directory size<br/>[recursive_size.rs]"]
  node_loc["Code counting<br/>[mod.rs]"]
end

subgraph group_views["Views and rendering"]
  node_view["View selection<br/>[view.rs]"]
  node_filename["Filename rendering<br/>[file_name.rs]"]
  node_details["Details view<br/>[details.rs]"]
  node_table["Column table<br/>[table.rs]"]
  node_grid["Grid view<br/>[grid.rs]"]
  node_grid_details["Grid details<br/>[grid_details.rs]"]
  node_code["Code summary<br/>[code.rs]"]
end

subgraph group_customization["Themes"]
  node_theme["Theme styling<br/>[mod.rs]"]
end

node_user(("Terminal user"))

node_user -->|"runs"| node_entry
node_entry -->|"parses options"| node_options
node_options -->|"defines arguments"| node_parser
node_options -->|"reads paths"| node_stdin
node_entry -->|"lists entries"| node_directory
node_entry -->|"uses metadata"| node_file
node_entry -->|"applies filtering"| node_filter
node_directory -->|"uses fields"| node_fields
node_file -->|"provides fields"| node_fields
node_file -->|"reads attributes"| node_xattrs
node_file -->|"gets mount info"| node_mounts
node_file -->|"gets total size"| node_recursive
node_directory -->|"uses Git cache"| node_git
node_git -->|"returns status fields"| node_fields
node_entry -->|"selects view"| node_view
node_view -->|"configures view"| node_details
node_view -->|"configures view"| node_grid
node_view -->|"configures view"| node_grid_details
node_view -->|"configures view"| node_code
node_entry -->|"counts source lines"| node_loc
node_details -->|"sorts files"| node_filter
node_details -->|"builds rows"| node_table
node_details -->|"formats names"| node_filename
node_table -->|"renders metadata"| node_fields
node_table -->|"looks up status"| node_git
node_entry -->|"loads theme"| node_theme
node_filename -->|"uses styles"| node_theme
node_table -->|"uses styles"| node_theme

click node_entry "https://github.com/eza-community/eza/blob/main/src/main.rs"
click node_options "https://github.com/eza-community/eza/blob/main/src/options/mod.rs"
click node_parser "https://github.com/eza-community/eza/blob/main/src/options/parser.rs"
click node_stdin "https://github.com/eza-community/eza/blob/main/src/options/stdin.rs"
click node_directory "https://github.com/eza-community/eza/blob/main/src/fs/dir.rs"
click node_file "https://github.com/eza-community/eza/blob/main/src/fs/file.rs"
click node_filter "https://github.com/eza-community/eza/blob/main/src/fs/filter.rs"
click node_fields "https://github.com/eza-community/eza/blob/main/src/fs/fields.rs"
click node_git "https://github.com/eza-community/eza/blob/main/src/fs/feature/git.rs"
click node_xattrs "https://github.com/eza-community/eza/blob/main/src/fs/feature/xattr.rs"
click node_mounts "https://github.com/eza-community/eza/blob/main/src/fs/mounts/mod.rs"
click node_recursive "https://github.com/eza-community/eza/blob/main/src/fs/recursive_size.rs"
click node_loc "https://github.com/eza-community/eza/blob/main/src/loc/mod.rs"
click node_view "https://github.com/eza-community/eza/blob/main/src/options/view.rs"
click node_filename "https://github.com/eza-community/eza/blob/main/src/output/file_name.rs"
click node_details "https://github.com/eza-community/eza/blob/main/src/output/details.rs"
click node_table "https://github.com/eza-community/eza/blob/main/src/output/table.rs"
click node_grid "https://github.com/eza-community/eza/blob/main/src/output/grid.rs"
click node_grid_details "https://github.com/eza-community/eza/blob/main/src/output/grid_details.rs"
click node_code "https://github.com/eza-community/eza/blob/main/src/output/code.rs"
click node_theme "https://github.com/eza-community/eza/blob/main/src/theme/mod.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_entry,node_options,node_parser,node_stdin,node_user toneBlue
class node_directory,node_file,node_filter,node_fields toneAmber
class node_git,node_xattrs,node_mounts,node_recursive,node_loc toneMint
class node_view,node_filename,node_details,node_table,node_grid,node_grid_details,node_code toneRose
class node_theme toneIndigo
```

## Components

### Command line

- [CLI entry](https://github.com/eza-community/eza/blob/main/src/main.rs): `src/main.rs`
- [Option handling](https://github.com/eza-community/eza/blob/main/src/options/mod.rs): `src/options/mod.rs`
- [Argument parser](https://github.com/eza-community/eza/blob/main/src/options/parser.rs): `src/options/parser.rs`
- [Stdin paths](https://github.com/eza-community/eza/blob/main/src/options/stdin.rs): `src/options/stdin.rs`

### Filesystem data

- [Directory entries](https://github.com/eza-community/eza/blob/main/src/fs/dir.rs): `src/fs/dir.rs`
- [File metadata](https://github.com/eza-community/eza/blob/main/src/fs/file.rs): `src/fs/file.rs`
- [Sort and filter](https://github.com/eza-community/eza/blob/main/src/fs/filter.rs): `src/fs/filter.rs`
- [Metadata fields](https://github.com/eza-community/eza/blob/main/src/fs/fields.rs): `src/fs/fields.rs`

### Metadata features

- [Git status](https://github.com/eza-community/eza/blob/main/src/fs/feature/git.rs): `src/fs/feature/git.rs`
- [Extended attributes](https://github.com/eza-community/eza/blob/main/src/fs/feature/xattr.rs): `src/fs/feature/xattr.rs`
- [Mount details](https://github.com/eza-community/eza/blob/main/src/fs/mounts/mod.rs): `src/fs/mounts/mod.rs`
- [Directory size](https://github.com/eza-community/eza/blob/main/src/fs/recursive_size.rs): `src/fs/recursive_size.rs`
- [Code counting](https://github.com/eza-community/eza/blob/main/src/loc/mod.rs): `src/loc/mod.rs`

### Views and rendering

- [View selection](https://github.com/eza-community/eza/blob/main/src/options/view.rs): `src/options/view.rs`
- [Filename rendering](https://github.com/eza-community/eza/blob/main/src/output/file_name.rs): `src/output/file_name.rs`
- [Details view](https://github.com/eza-community/eza/blob/main/src/output/details.rs): `src/output/details.rs`
- [Column table](https://github.com/eza-community/eza/blob/main/src/output/table.rs): `src/output/table.rs`
- [Grid view](https://github.com/eza-community/eza/blob/main/src/output/grid.rs): `src/output/grid.rs`
- [Grid details](https://github.com/eza-community/eza/blob/main/src/output/grid_details.rs): `src/output/grid_details.rs`
- [Code summary](https://github.com/eza-community/eza/blob/main/src/output/code.rs): `src/output/code.rs`

### Themes

- [Theme styling](https://github.com/eza-community/eza/blob/main/src/theme/mod.rs): `src/theme/mod.rs`

### Other components

- **Terminal user**

## Connections

- Terminal user → CLI entry: runs (evidence: `README.md`)
- CLI entry → Option handling: parses options (evidence: `src/main.rs`)
- Option handling → Argument parser: defines arguments (evidence: `src/options/mod.rs`)
- Option handling → Stdin paths: reads paths (evidence: `src/options/mod.rs`)
- CLI entry → Directory entries: lists entries (evidence: `src/main.rs`)
- CLI entry → File metadata: uses metadata (evidence: `src/main.rs`)
- CLI entry → Sort and filter: applies filtering (evidence: `src/main.rs`)
- Directory entries → Metadata fields: uses fields (evidence: `src/fs/dir.rs`)
- File metadata → Metadata fields: provides fields (evidence: `src/fs/file.rs`)
- File metadata → Extended attributes: reads attributes (evidence: `src/fs/file.rs`)
- File metadata → Mount details: gets mount info (evidence: `src/fs/file.rs`)
- File metadata → Directory size: gets total size (evidence: `src/fs/file.rs`)
- Directory entries → Git status: uses Git cache (evidence: `src/fs/dir.rs`)
- Git status → Metadata fields: returns status fields (evidence: `src/fs/feature/git.rs`)
- CLI entry → View selection: selects view (evidence: `src/main.rs`)
- View selection → Details view: configures view (evidence: `src/options/view.rs`)
- View selection → Grid view: configures view (evidence: `src/options/view.rs`)
- View selection → Grid details: configures view (evidence: `src/options/view.rs`)
- View selection → Code summary: configures view (evidence: `src/options/view.rs`)
- CLI entry → Code counting: counts source lines (evidence: `src/main.rs`)
- Details view → Sort and filter: sorts files (evidence: `src/output/details.rs`)
- Details view → Column table: builds rows (evidence: `src/output/details.rs`)
- Details view → Filename rendering: formats names (evidence: `src/output/details.rs`)
- Column table → Metadata fields: renders metadata (evidence: `src/output/table.rs`)
- Column table → Git status: looks up status (evidence: `src/output/table.rs`)
- CLI entry → Theme styling: loads theme (evidence: `src/main.rs`)
- Filename rendering → Theme styling: uses styles (evidence: `src/output/file_name.rs`)
- Column table → Theme styling: uses styles (evidence: `src/output/table.rs`)
