How oughie/clock-rs works
clock-rs is a terminal digital clock with clock, timer, and stopwatch modes. Its workflow parses CLI options and configuration, selects a time or counter mode, then renders a formatted display in an interactive terminal loop; users can pause/restart counters and reload settings. Groups distinguish input/configuration, timekeeping, and presentation/runtime layers. The graph follows shown calls and README-described behavior; configuration-file details beyond the sampled parser are omitted.
Main entry points: state.rs App state · mod.rs Clock formatter · mode.rs Clock modes · config.rs Settings parser
Components 17
Inputs and configuration
- CLI options
src/cli/args.rs - Settings parser
src/config.rs - CLI overrides
src/cli/mod.rs - TOML settings file
Time and counters
- Clock modes
src/clock/mode.rs - Timer and stopwatch
src/clock/counter.rs - Local and UTC time
src/clock/time_zone.rs
Terminal display
- Clock formatter
src/clock/mod.rs - Digit characters
src/character.rs - Glyph segments
src/segment.rs - Color formatting
src/color.rs - Position layout
src/position.rs
Application runtime
- App state
src/state.rs - Mode selection
src/state.rs - Terminal I/O
src/state.rs - Error reporting
src/error.rs
Other components
- Terminal user
Connections 21
- Terminal user → App state: starts app
- App state → CLI options: parses options
src/state.rs - App state → Settings parser: loads settings
src/state.rs - App state → CLI overrides: applies overrides
src/state.rs - CLI options → CLI overrides: provides values
src/cli/mod.rs - TOML settings file → Settings parser: reads TOML
src/config.rs - App state → Mode selection: selects mode
src/state.rs - Mode selection → Clock modes: constructs
src/state.rs - Mode selection → Timer and stopwatch: creates counter
src/state.rs - Clock modes → Local and UTC time: gets time
- App state → Clock formatter: configures display
src/state.rs - Clock formatter → Clock modes: formats mode
src/clock/mod.rs - Clock formatter → Digit characters: formats digits
src/clock/mod.rs - Digit characters → Glyph segments: formats glyph
src/character.rs - Clock formatter → Color formatting: applies color
src/clock/mod.rs - Clock formatter → Position layout: calculates layout
src/clock/mod.rs - App state → Terminal I/O: renders and polls
src/state.rs - Terminal I/O → Clock formatter: renders display
src/state.rs - Terminal I/O → Timer and stopwatch: pauses or restarts
src/state.rs - Terminal I/O → Settings parser: reloads settings
src/state.rs - App state → Error reporting: reports failures
src/main.rs