How qlever-dev/qlever-control works
QLever Control is a Python CLI for configuring and operating the QLever RDF/SPARQL database. Its main workflow is to load Qleverfile settings, run an operational command (such as building an index or issuing queries), and interact with the QLever server. A substantial companion capability is the query-monitor TUI, which reads query and resource logs and presents live and historic views. The graph includes documented command families whose implementations were not sampled; their internal calls are therefore left unasserted.
Main entry points: views Live and historic views · app.py Monitor TUI · live_data.py Live query state · qlever_main.py CLI entry
Components 23
CLI and configuration
- CLI entry
src/qlever/qlever_main.py - Config loading
src/qlever/config.py - Qleverfile
src/qlever/qleverfile.py - Command contract
src/qlever/command.py
Database operations
- Index lifecycle
src/qlever/commands/index.py - SPARQL queries
src/qlever/commands/query.py - Server control
src/qlever/commands/start.py - Data updates
src/qlever/commands/update.py
Query monitoring
- Monitor TUI
src/qlever/monitor_queries/app.py - Live query state
src/qlever/monitor_queries/live_data.py - Historic queries
src/qlever/monitor_queries/historic_data.py - Resource readings
src/qlever/monitor_queries/resource_data.py - Query log reader
src/qlever/monitor_queries/log_reader.py - Monitor models
src/qlever/monitor_queries/models.py - Live and historic views
src/qlever/monitor_queries/views - Query tables
src/qlever/monitor_queries/widgets/query_table.py - Resource plot
src/qlever/monitor_queries/widgets/resource_plot_pane.py
Evaluation tools
- Query benchmarks
src/qlever/commands/benchmark_queries.py - Evaluation UI
src/qlever/commands/serve_evaluation_app.py - Execution comparison
src/qlever/evaluation/www/comparison.js
Other components
- Operator
- Query log
- Resource log
Connections 25
- Operator → CLI entry: runs CLI
- CLI entry → Config loading: loads settings
src/qlever/qlever_main.py - Config loading → Qleverfile: parses settings
src/qlever/config.py - CLI entry → Command contract: dispatches commands
- Index lifecycle → Command contract: implements contract
src/qlever/commands/index.py - SPARQL queries → Command contract: implements contract
src/qlever/commands/query.py - Index lifecycle → Resource plot: renders usage plots
src/qlever/commands/index.py - Operator → Monitor TUI: opens monitor
- Monitor TUI → Live query state: starts log tailer
src/qlever/monitor_queries/app.py - Monitor TUI → Live and historic views: shows screens
src/qlever/monitor_queries/app.py - Monitor TUI → Query log: tails
src/qlever/monitor_queries/app.py - Live query state → Query log reader: parses events
src/qlever/monitor_queries/live_data.py - Historic queries → Query log reader: reads log data
src/qlever/monitor_queries/historic_data.py - Historic queries → Monitor models: produces rows
src/qlever/monitor_queries/historic_data.py - Live query state → Monitor models: produces rows
src/qlever/monitor_queries/live_data.py - Resource readings → Monitor models: produces series
src/qlever/monitor_queries/resource_data.py - Resource readings → Resource log: reads samples
- Live and historic views → Historic queries: loads history
src/qlever/monitor_queries/views/historic.py - Live and historic views → Live query state: reads live state
src/qlever/monitor_queries/views/live.py - Live and historic views → Resource readings: loads readings
src/qlever/monitor_queries/views/historic.py - Live and historic views → Query tables: renders queries
src/qlever/monitor_queries/views/live.py - Live and historic views → Resource plot: renders resources
src/qlever/monitor_queries/views/resource_plot_modal.py - Operator → Query benchmarks: runs benchmarks
- Operator → Evaluation UI: opens evaluation
- Evaluation UI → Execution comparison: serves interface