# adlerzz/svetilo architecture

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

- Interactive diagram: https://gitdiagram.com/adlerzz/svetilo
- Repository: https://github.com/adlerzz/svetilo

## Overview

This is a small C++ command-parsing prototype, not a complete application: its sample entry point splits command strings, looks up an operation token, and prints a representation. The token table describes time, date, alarm, and mode operations and associates them with argument factories; argument parsers cover time, date, and weekday patterns, though the shown entry point does not invoke those parsers or create arguments. The graph reflects these documented structures and calls, not an end-to-end working command flow; the README is empty.

Main entry points: [`src/main.cpp`](https://github.com/adlerzz/svetilo/blob/main/src/main.cpp) (Sample runner), [`src/datatypes/tokens/tokens.cpp`](https://github.com/adlerzz/svetilo/blob/main/src/datatypes/tokens/tokens.cpp) (Operation lookup), [`src/datatypes/tokens/tokens.h`](https://github.com/adlerzz/svetilo/blob/main/src/datatypes/tokens/tokens.h) (Operation registry), [`src/datatypes/args/arg.h`](https://github.com/adlerzz/svetilo/blob/main/src/datatypes/args/arg.h) (Argument types)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Command workflow"]
  node_entry["Sample runner<br/>[main.cpp]"]
  node_display["Command display<br/>[main.cpp]"]
end

subgraph group_model["Command model"]
  node_lookup["Operation lookup<br/>[tokens.cpp]"]
  node_registry["Operation registry<br/>[tokens.h]"]
  node_values["Opcode and options<br/>[datatypes.h]"]
end

subgraph group_text["Text and arguments"]
  node_split["Command splitter<br/>[strmanip.cpp]"]
  node_argtypes["Argument types<br/>[arg.h]"]
  node_argparse["Argument parsers<br/>[arg.cpp]"]
  node_strings["String helpers<br/>[strmanip.cpp]"]
  node_stringtypes["String collection<br/>[strmanip.h]"]
end

node_user(("Command input"))

node_user -->|"provides examples"| node_entry
node_entry -->|"splits command"| node_split
node_entry -->|"looks up operation"| node_lookup
node_entry -->|"prints command"| node_display
node_lookup -->|"searches tokens"| node_registry
node_registry -->|"associates factories"| node_argtypes
node_argparse -->|"parses integers"| node_strings
node_argtypes -->|"uses argument strings"| node_stringtypes
node_strings -->|"defines collection"| node_stringtypes
node_display -->|"formats token values"| node_values

click node_entry "https://github.com/adlerzz/svetilo/blob/main/src/main.cpp"
click node_split "https://github.com/adlerzz/svetilo/blob/main/src/strmanip/strmanip.cpp"
click node_lookup "https://github.com/adlerzz/svetilo/blob/main/src/datatypes/tokens/tokens.cpp"
click node_registry "https://github.com/adlerzz/svetilo/blob/main/src/datatypes/tokens/tokens.h"
click node_display "https://github.com/adlerzz/svetilo/blob/main/src/main.cpp"
click node_values "https://github.com/adlerzz/svetilo/blob/main/src/datatypes/datatypes.h"
click node_argtypes "https://github.com/adlerzz/svetilo/blob/main/src/datatypes/args/arg.h"
click node_argparse "https://github.com/adlerzz/svetilo/blob/main/src/datatypes/args/arg.cpp"
click node_strings "https://github.com/adlerzz/svetilo/blob/main/src/strmanip/strmanip.cpp"
click node_stringtypes "https://github.com/adlerzz/svetilo/blob/main/src/strmanip/strmanip.h"

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_display toneBlue
class node_lookup,node_registry,node_values toneAmber
class node_split,node_argtypes,node_argparse,node_strings,node_stringtypes toneMint
class node_user toneIndigo
```

## Components

### Command workflow

- [Sample runner](https://github.com/adlerzz/svetilo/blob/main/src/main.cpp): `src/main.cpp`
- [Command display](https://github.com/adlerzz/svetilo/blob/main/src/main.cpp): `src/main.cpp`

### Command model

- [Operation lookup](https://github.com/adlerzz/svetilo/blob/main/src/datatypes/tokens/tokens.cpp): `src/datatypes/tokens/tokens.cpp`
- [Operation registry](https://github.com/adlerzz/svetilo/blob/main/src/datatypes/tokens/tokens.h): `src/datatypes/tokens/tokens.h`
- [Opcode and options](https://github.com/adlerzz/svetilo/blob/main/src/datatypes/datatypes.h): `src/datatypes/datatypes.h`

### Text and arguments

- [Command splitter](https://github.com/adlerzz/svetilo/blob/main/src/strmanip/strmanip.cpp): `src/strmanip/strmanip.cpp`
- [Argument types](https://github.com/adlerzz/svetilo/blob/main/src/datatypes/args/arg.h): `src/datatypes/args/arg.h`
- [Argument parsers](https://github.com/adlerzz/svetilo/blob/main/src/datatypes/args/arg.cpp): `src/datatypes/args/arg.cpp`
- [String helpers](https://github.com/adlerzz/svetilo/blob/main/src/strmanip/strmanip.cpp): `src/strmanip/strmanip.cpp`
- [String collection](https://github.com/adlerzz/svetilo/blob/main/src/strmanip/strmanip.h): `src/strmanip/strmanip.h`

### Other components

- **Command input**

## Connections

- Command input → Sample runner: provides examples (evidence: `src/main.cpp`)
- Sample runner → Command splitter: splits command (evidence: `src/main.cpp`)
- Sample runner → Operation lookup: looks up operation (evidence: `src/main.cpp`)
- Sample runner → Command display: prints command (evidence: `src/main.cpp`)
- Operation lookup → Operation registry: searches tokens (evidence: `src/datatypes/tokens/tokens.cpp`)
- Operation registry → Argument types: associates factories (evidence: `src/datatypes/tokens/tokens.h`)
- Argument parsers → String helpers: parses integers (evidence: `src/datatypes/args/arg.cpp`)
- Argument types → String collection: uses argument strings (evidence: `src/datatypes/args/arg.h`)
- String helpers → String collection: defines collection (evidence: `src/strmanip/strmanip.h`)
- Command display → Opcode and options: formats token values (evidence: `src/main.cpp`)
