laketower 0.2.0__tar.gz → 0.4.0__tar.gz

{laketower-0.2.0 → laketower-0.4.0}/.github/workflows/ci-cd.yml

@@ -14,7 +14,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        python-version: ["3.9", "3.10", "3.11", "3.12", "3.13"]
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
     steps:
       - uses: actions/checkout@v4
       - name: Install uv

{laketower-0.2.0 → laketower-0.4.0}/CHANGELOG.md

@@ -7,6 +7,28 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.4.0] - 2025-03-01
+Introducing new features:
+- Display tables statistics
+- List and execute pre-defined queries
+
+### Added
+- web: add queries view page
+- web: add table statistics page with version control
+- cli: add queries view command
+- cli: add queries list command
+- cli: add table statistics command
+
+## [0.3.0] - 2025-02-27
+Minor release with fixes and dropped Python 3.9 support.
+
+### BREAKING CHANGES
+- deps: drop support for python 3.9
+
+### Fixed
+- web: handle invalid tables sql query
+- web: truncate long table names in sidebar
+
 ## [0.2.0] - 2025-02-25
 Introducing the Laketower web application!
 
@@ -37,6 +59,8 @@ Initial release of `laketower`.
     - View a given table with simple query builder
     - Query all registered tables with DuckDB SQL dialect
 
-[Unreleased]: https://github.com/datalpia/laketower/compare/0.2.0...HEAD
+[Unreleased]: https://github.com/datalpia/laketower/compare/0.4.0...HEAD
+[0.4.0]: https://github.com/datalpia/laketower/compare/0.3.0...0.4.0
+[0.3.0]: https://github.com/datalpia/laketower/compare/0.2.0...0.3.0
 [0.2.0]: https://github.com/datalpia/laketower/compare/0.1.0...0.2.0
 [0.1.0]: https://github.com/datalpia/laketower/releases/tag/0.1.0

{laketower-0.2.0 → laketower-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: laketower
-Version: 0.2.0
+Version: 0.4.0
 Summary: Oversee your lakehouse
 Project-URL: Repository, https://github.com/datalpia/laketower
 Project-URL: Issues, https://github.com/datalpia/laketower/issues
@@ -14,7 +14,6 @@ Classifier: Intended Audience :: Developers
 Classifier: Intended Audience :: End Users/Desktop
 Classifier: Intended Audience :: Information Technology
 Classifier: Intended Audience :: Other Audience
-Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
@@ -22,7 +21,7 @@ Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Database
 Classifier: Topic :: Software Development
 Classifier: Topic :: Utilities
-Requires-Python: <3.14,>=3.9
+Requires-Python: <3.14,>=3.10
 Requires-Dist: deltalake
 Requires-Dist: duckdb
 Requires-Dist: fastapi
@@ -54,8 +53,10 @@ Utility application to explore and manage tables in your data lakehouse, especia
 - Inspect table metadata
 - Inspect table schema
 - Inspect table history
+- Get table statistics
 - View table content with a simple query builder
 - Query all registered tables with DuckDB SQL dialect
+- Execute saved queries
 - Static and versionable YAML configuration
 - Web application
 - CLI application
@@ -106,6 +107,30 @@ tables:
   - name: weather
     uri: demo/weather
     format: delta
+
+queries:
+  - name: all_data
+    title: All data
+    sql: |
+      select
+        sample_table.*,
+        weather.*
+      from
+        sample_table,
+        weather
+      limit 10
+  - name: daily_avg_temperature
+    title: Daily average temperature
+    sql: |
+      select
+        date_trunc('day', time) as day,
+        round(avg(temperature_2m)) as avg_temperature
+      from
+        weather
+      group by
+        day
+      order by
+        day asc
 ```
 
 ### Web Application
@@ -122,18 +147,20 @@ Laketower provides a CLI interface:
 
 ```bash
 $ laketower --help
-usage: laketower [-h] [--version] [--config CONFIG] {web,config,tables} ...
+
+usage: laketower [-h] [--version] [--config CONFIG] {web,config,tables,queries} ...
 
 options:
-  -h, --help           show this help message and exit
-  --version            show program's version number and exit
-  --config, -c CONFIG  Path to the Laketower YAML configuration file (default: laketower.yml)
+  -h, --help            show this help message and exit
+  --version             show program's version number and exit
+  --config, -c CONFIG   Path to the Laketower YAML configuration file (default: laketower.yml)
 
 commands:
-  {web,config,tables}
-    web                Launch the web application
-    config             Work with configuration
-    tables             Work with tables
+  {web,config,tables,queries}
+    web                 Launch the web application
+    config              Work with configuration
+    tables              Work with tables
+    queries             Work with queries
 ```
 
 By default, a YAML configuration file named `laketower.yml` will be looked for.
@@ -246,6 +273,40 @@ weather
     └── operation metrics
 ```
 
+#### Get statistics of a given table
+
+Get basic statistics on all columns of a given table:
+
+```bash
+$ laketower -c demo/laketower.yml tables statistics weather
+
+┏━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━┳━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━┓
+┃ column_name          ┃ count ┃ avg                ┃ std                ┃ min                    ┃ max                    ┃
+┡━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━╇━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━┩
+│ time                 │ 576   │ None               │ None               │ 2025-01-26 01:00:00+01 │ 2025-02-12 00:00:00+01 │
+│ city                 │ 576   │ None               │ None               │ Grenoble               │ Grenoble               │
+│ temperature_2m       │ 576   │ 5.2623263956047595 │ 3.326529069892729  │ 0.0                    │ 15.1                   │
+│ relative_humidity_2m │ 576   │ 78.76909722222223  │ 15.701802163559918 │ 29.0                   │ 100.0                  │
+│ wind_speed_10m       │ 576   │ 7.535763886032833  │ 10.00898058743763  │ 0.0                    │ 42.4                   │
+└──────────────────────┴───────┴────────────────────┴────────────────────┴────────────────────────┴────────────────────────┘
+```
+
+Specifying a table version yields according results:
+
+```bash
+$ laketower -c demo/laketower.yml tables statistics --version 0 weather
+
+┏━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━┳━━━━━━┳━━━━━━┳━━━━━━┳━━━━━━┓
+┃ column_name          ┃ count ┃ avg  ┃ std  ┃ min  ┃ max  ┃
+┡━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━╇━━━━━━╇━━━━━━╇━━━━━━╇━━━━━━┩
+│ time                 │ 0     │ None │ None │ None │ None │
+│ city                 │ 0     │ None │ None │ None │ None │
+│ temperature_2m       │ 0     │ None │ None │ None │ None │
+│ relative_humidity_2m │ 0     │ None │ None │ None │ None │
+│ wind_speed_10m       │ 0     │ None │ None │ None │ None │
+└──────────────────────┴───────┴──────┴──────┴──────┴──────┘
+```
+
 #### View a given table
 
 Using a simple query builder, the content of a table can be displayed.
@@ -309,7 +370,6 @@ $ laketower -c demo/laketower.yml tables view weather --version 1
 └───────────────────────────┴──────────┴───────────────────┴──────────────────────┴────────────────────┘
 ```
 
-
 #### Query all registered tables
 
 Query any registered tables using DuckDB SQL dialect!
@@ -326,6 +386,45 @@ $ laketower -c demo/laketower.yml tables query "select date_trunc('day', time) a
 └───────────────────────────┴────────────────────┘
 ```
 
+#### List saved queries
+
+```bash
+$ laketower -c demo/laketower.yml queries list
+
+queries
+├── all_data
+└── daily_avg_temperature
+```
+
+#### Execute saved queries
+
+```bash
+$ laketower -c demo/laketower.yml queries view daily_avg_temperature
+
+┏━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━┓
+┃ day                       ┃ avg_temperature ┃
+┡━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━┩
+│ 2025-01-26 00:00:00+01:00 │ 8.0             │
+│ 2025-01-27 00:00:00+01:00 │ 13.0            │
+│ 2025-01-28 00:00:00+01:00 │ 7.0             │
+│ 2025-01-29 00:00:00+01:00 │ 8.0             │
+│ 2025-01-30 00:00:00+01:00 │ 9.0             │
+│ 2025-01-31 00:00:00+01:00 │ 6.0             │
+│ 2025-02-01 00:00:00+01:00 │ 4.0             │
+│ 2025-02-02 00:00:00+01:00 │ 4.0             │
+│ 2025-02-03 00:00:00+01:00 │ 4.0             │
+│ 2025-02-04 00:00:00+01:00 │ 3.0             │
+│ 2025-02-05 00:00:00+01:00 │ 3.0             │
+│ 2025-02-06 00:00:00+01:00 │ 2.0             │
+│ 2025-02-07 00:00:00+01:00 │ 6.0             │
+│ 2025-02-08 00:00:00+01:00 │ 7.0             │
+│ 2025-02-09 00:00:00+01:00 │ 5.0             │
+│ 2025-02-10 00:00:00+01:00 │ 2.0             │
+│ 2025-02-11 00:00:00+01:00 │ 5.0             │
+│ 2025-02-12 00:00:00+01:00 │ 5.0             │
+└───────────────────────────┴─────────────────┘
+```
+
 ## License
 
 Licensed under [GNU Affero General Public License v3.0 (AGPLv3)](LICENSE.md)

{laketower-0.2.0 → laketower-0.4.0}/README.md

@@ -15,8 +15,10 @@ Utility application to explore and manage tables in your data lakehouse, especia
 - Inspect table metadata
 - Inspect table schema
 - Inspect table history
+- Get table statistics
 - View table content with a simple query builder
 - Query all registered tables with DuckDB SQL dialect
+- Execute saved queries
 - Static and versionable YAML configuration
 - Web application
 - CLI application
@@ -67,6 +69,30 @@ tables:
   - name: weather
     uri: demo/weather
     format: delta
+
+queries:
+  - name: all_data
+    title: All data
+    sql: |
+      select
+        sample_table.*,
+        weather.*
+      from
+        sample_table,
+        weather
+      limit 10
+  - name: daily_avg_temperature
+    title: Daily average temperature
+    sql: |
+      select
+        date_trunc('day', time) as day,
+        round(avg(temperature_2m)) as avg_temperature
+      from
+        weather
+      group by
+        day
+      order by
+        day asc
 ```
 
 ### Web Application
@@ -83,18 +109,20 @@ Laketower provides a CLI interface:
 
 ```bash
 $ laketower --help
-usage: laketower [-h] [--version] [--config CONFIG] {web,config,tables} ...
+
+usage: laketower [-h] [--version] [--config CONFIG] {web,config,tables,queries} ...
 
 options:
-  -h, --help           show this help message and exit
-  --version            show program's version number and exit
-  --config, -c CONFIG  Path to the Laketower YAML configuration file (default: laketower.yml)
+  -h, --help            show this help message and exit
+  --version             show program's version number and exit
+  --config, -c CONFIG   Path to the Laketower YAML configuration file (default: laketower.yml)
 
 commands:
-  {web,config,tables}
-    web                Launch the web application
-    config             Work with configuration
-    tables             Work with tables
+  {web,config,tables,queries}
+    web                 Launch the web application
+    config              Work with configuration
+    tables              Work with tables
+    queries             Work with queries
 ```
 
 By default, a YAML configuration file named `laketower.yml` will be looked for.
@@ -207,6 +235,40 @@ weather
     └── operation metrics
 ```
 
+#### Get statistics of a given table
+
+Get basic statistics on all columns of a given table:
+
+```bash
+$ laketower -c demo/laketower.yml tables statistics weather
+
+┏━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━┳━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━┓
+┃ column_name          ┃ count ┃ avg                ┃ std                ┃ min                    ┃ max                    ┃
+┡━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━╇━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━┩
+│ time                 │ 576   │ None               │ None               │ 2025-01-26 01:00:00+01 │ 2025-02-12 00:00:00+01 │
+│ city                 │ 576   │ None               │ None               │ Grenoble               │ Grenoble               │
+│ temperature_2m       │ 576   │ 5.2623263956047595 │ 3.326529069892729  │ 0.0                    │ 15.1                   │
+│ relative_humidity_2m │ 576   │ 78.76909722222223  │ 15.701802163559918 │ 29.0                   │ 100.0                  │
+│ wind_speed_10m       │ 576   │ 7.535763886032833  │ 10.00898058743763  │ 0.0                    │ 42.4                   │
+└──────────────────────┴───────┴────────────────────┴────────────────────┴────────────────────────┴────────────────────────┘
+```
+
+Specifying a table version yields according results:
+
+```bash
+$ laketower -c demo/laketower.yml tables statistics --version 0 weather
+
+┏━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━┳━━━━━━┳━━━━━━┳━━━━━━┳━━━━━━┓
+┃ column_name          ┃ count ┃ avg  ┃ std  ┃ min  ┃ max  ┃
+┡━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━╇━━━━━━╇━━━━━━╇━━━━━━╇━━━━━━┩
+│ time                 │ 0     │ None │ None │ None │ None │
+│ city                 │ 0     │ None │ None │ None │ None │
+│ temperature_2m       │ 0     │ None │ None │ None │ None │
+│ relative_humidity_2m │ 0     │ None │ None │ None │ None │
+│ wind_speed_10m       │ 0     │ None │ None │ None │ None │
+└──────────────────────┴───────┴──────┴──────┴──────┴──────┘
+```
+
 #### View a given table
 
 Using a simple query builder, the content of a table can be displayed.
@@ -270,7 +332,6 @@ $ laketower -c demo/laketower.yml tables view weather --version 1
 └───────────────────────────┴──────────┴───────────────────┴──────────────────────┴────────────────────┘
 ```
 
-
 #### Query all registered tables
 
 Query any registered tables using DuckDB SQL dialect!
@@ -287,6 +348,45 @@ $ laketower -c demo/laketower.yml tables query "select date_trunc('day', time) a
 └───────────────────────────┴────────────────────┘
 ```
 
+#### List saved queries
+
+```bash
+$ laketower -c demo/laketower.yml queries list
+
+queries
+├── all_data
+└── daily_avg_temperature
+```
+
+#### Execute saved queries
+
+```bash
+$ laketower -c demo/laketower.yml queries view daily_avg_temperature
+
+┏━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━┓
+┃ day                       ┃ avg_temperature ┃
+┡━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━┩
+│ 2025-01-26 00:00:00+01:00 │ 8.0             │
+│ 2025-01-27 00:00:00+01:00 │ 13.0            │
+│ 2025-01-28 00:00:00+01:00 │ 7.0             │
+│ 2025-01-29 00:00:00+01:00 │ 8.0             │
+│ 2025-01-30 00:00:00+01:00 │ 9.0             │
+│ 2025-01-31 00:00:00+01:00 │ 6.0             │
+│ 2025-02-01 00:00:00+01:00 │ 4.0             │
+│ 2025-02-02 00:00:00+01:00 │ 4.0             │
+│ 2025-02-03 00:00:00+01:00 │ 4.0             │
+│ 2025-02-04 00:00:00+01:00 │ 3.0             │
+│ 2025-02-05 00:00:00+01:00 │ 3.0             │
+│ 2025-02-06 00:00:00+01:00 │ 2.0             │
+│ 2025-02-07 00:00:00+01:00 │ 6.0             │
+│ 2025-02-08 00:00:00+01:00 │ 7.0             │
+│ 2025-02-09 00:00:00+01:00 │ 5.0             │
+│ 2025-02-10 00:00:00+01:00 │ 2.0             │
+│ 2025-02-11 00:00:00+01:00 │ 5.0             │
+│ 2025-02-12 00:00:00+01:00 │ 5.0             │
+└───────────────────────────┴─────────────────┘
+```
+
 ## License
 
 Licensed under [GNU Affero General Public License v3.0 (AGPLv3)](LICENSE.md)

laketower-0.4.0/demo/laketower.yml

@@ -0,0 +1,31 @@
+tables:
+  - name: sample_table
+    uri: demo/sample_table
+    format: delta
+  - name: weather
+    uri: demo/weather
+    format: delta
+
+queries:
+  - name: all_data
+    title: All data
+    sql: |
+      select
+        sample_table.*,
+        weather.*
+      from
+        sample_table,
+        weather
+      limit 10
+  - name: daily_avg_temperature
+    title: Daily average temperature
+    sql: |
+      select
+        date_trunc('day', time) as day,
+        round(avg(temperature_2m)) as avg_temperature
+      from
+        weather
+      group by
+        day
+      order by
+        day asc

laketower-0.4.0/laketower/__about__.py

@@ -0,0 +1 @@
+__version__ = "0.4.0"

{laketower-0.2.0 → laketower-0.4.0}/laketower/cli.py

@@ -1,5 +1,3 @@
-from __future__ import annotations
-
 import argparse
 import os
 from pathlib import Path
@@ -13,7 +11,12 @@ import uvicorn
 
 from laketower.__about__ import __version__
 from laketower.config import load_yaml_config
-from laketower.tables import execute_query, generate_table_query, load_table
+from laketower.tables import (
+    execute_query,
+    generate_table_query,
+    generate_table_statistics_query,
+    load_table,
+)
 
 
 def run_web(config_path: Path, reload: bool) -> None:  # pragma: no cover
@@ -99,6 +102,27 @@ def table_history(config_path: Path, table_name: str) -> None:
     console.print(tree, markup=False)
 
 
+def table_statistics(
+    config_path: Path, table_name: str, version: int | None = None
+) -> None:
+    config = load_yaml_config(config_path)
+    table_config = next(filter(lambda x: x.name == table_name, config.tables))
+    table = load_table(table_config)
+    table_dataset = table.dataset(version=version)
+    sql_query = generate_table_statistics_query(table_name)
+    results = execute_query({table_name: table_dataset}, sql_query)
+
+    out = rich.table.Table()
+    for column in results.columns:
+        out.add_column(column)
+    for value_list in results.to_numpy().tolist():
+        row = [str(x) for x in value_list]
+        out.add_row(*row)
+
+    console = rich.get_console()
+    console.print(out, markup=False)  # disable markup to allow bracket characters
+
+
 def view_table(
     config_path: Path,
     table_name: str,
@@ -151,6 +175,40 @@ def query_table(config_path: Path, sql_query: str) -> None:
     console.print(out)
 
 
+def list_queries(config_path: Path) -> None:
+    config = load_yaml_config(config_path)
+    tree = rich.tree.Tree("queries")
+    for query in config.queries:
+        tree.add(query.name)
+    console = rich.get_console()
+    console.print(tree)
+
+
+def view_query(config_path: Path, query_name: str) -> None:
+    config = load_yaml_config(config_path)
+    query_config = next(filter(lambda x: x.name == query_name, config.queries))
+    sql_query = query_config.sql
+    tables_dataset = {
+        table_config.name: load_table(table_config).dataset()
+        for table_config in config.tables
+    }
+
+    out: rich.jupyter.JupyterMixin
+    try:
+        results = execute_query(tables_dataset, sql_query)
+        out = rich.table.Table()
+        for column in results.columns:
+            out.add_column(column)
+        for value_list in results.values.tolist():
+            row = [str(x) for x in value_list]
+            out.add_row(*row)
+    except ValueError as e:
+        out = rich.panel.Panel.fit(f"[red]{e}")
+
+    console = rich.get_console()
+    console.print(out)
+
+
 def cli() -> None:
     parser = argparse.ArgumentParser(
         "laketower", formatter_class=argparse.ArgumentDefaultsHelpFormatter
@@ -214,6 +272,17 @@ def cli() -> None:
     parser_tables_history.add_argument("table", help="Name of the table")
     parser_tables_history.set_defaults(func=lambda x: table_history(x.config, x.table))
 
+    parser_tables_statistics = subsparsers_tables.add_parser(
+        "statistics", help="Display summary statistics of a given table schema"
+    )
+    parser_tables_statistics.add_argument("table", help="Name of the table")
+    parser_tables_statistics.add_argument(
+        "--version", type=int, help="Time-travel to table revision number"
+    )
+    parser_tables_statistics.set_defaults(
+        func=lambda x: table_statistics(x.config, x.table, x.version)
+    )
+
     parser_tables_view = subsparsers_tables.add_parser(
         "view", help="View a given table"
     )
@@ -244,5 +313,19 @@ def cli() -> None:
     parser_tables_query.add_argument("sql", help="SQL query to execute")
     parser_tables_query.set_defaults(func=lambda x: query_table(x.config, x.sql))
 
+    parser_queries = subparsers.add_parser("queries", help="Work with queries")
+    subsparsers_queries = parser_queries.add_subparsers(required=True)
+
+    parser_queries_list = subsparsers_queries.add_parser(
+        "list", help="List all registered queries"
+    )
+    parser_queries_list.set_defaults(func=lambda x: list_queries(x.config))
+
+    parser_queries_view = subsparsers_queries.add_parser(
+        "view", help="View a given query"
+    )
+    parser_queries_view.add_argument("query", help="Name of the query")
+    parser_queries_view.set_defaults(func=lambda x: view_query(x.config, x.query))
+
     args = parser.parse_args()
     args.func(args)

{laketower-0.2.0 → laketower-0.4.0}/laketower/config.py

@@ -29,6 +29,7 @@ class ConfigTable(pydantic.BaseModel):
 
 class ConfigQuery(pydantic.BaseModel):
     name: str
+    title: str
     sql: str
 
 
@@ -38,6 +39,7 @@ class ConfigDashboard(pydantic.BaseModel):
 
 class Config(pydantic.BaseModel):
     tables: list[ConfigTable] = []
+    queries: list[ConfigQuery] = []
 
 
 def load_yaml_config(config_path: Path) -> Config:

{laketower-0.2.0 → laketower-0.4.0}/laketower/tables.py

@@ -1,7 +1,5 @@
-from __future__ import annotations
-
 from datetime import datetime, timezone
-from typing import Any, Optional, Protocol
+from typing import Any, Protocol
 
 import deltalake
 import duckdb
@@ -11,6 +9,7 @@ import pyarrow.dataset as padataset
 import pydantic
 import sqlglot
 import sqlglot.dialects.duckdb
+import sqlglot.expressions
 
 from laketower.config import ConfigTable, TableFormats
 
@@ -20,8 +19,8 @@ DEFAULT_LIMIT = 10
 
 class TableMetadata(pydantic.BaseModel):
     table_format: TableFormats
-    name: Optional[str] = None
-    description: Optional[str] = None
+    name: str | None = None
+    description: str | None = None
     uri: str
     id: str
     version: int
@@ -33,7 +32,7 @@ class TableMetadata(pydantic.BaseModel):
 class TableRevision(pydantic.BaseModel):
     version: int
     timestamp: datetime
-    client_version: Optional[str] = None
+    client_version: str | None = None
     operation: str
     operation_parameters: dict[str, Any]
     operation_metrics: dict[str, Any]
@@ -122,6 +121,12 @@ def generate_table_query(
     )
 
 
+def generate_table_statistics_query(table_name: str) -> str:
+    return (
+        f"SELECT column_name, count, avg, std, min, max FROM (SUMMARIZE {table_name})"  # nosec B608
+    )
+
+
 def execute_query(
     tables_datasets: dict[str, padataset.Dataset], sql_query: str
 ) -> pd.DataFrame:

{laketower-0.2.0 → laketower-0.4.0}/laketower/templates/_base.html

@@ -19,7 +19,14 @@
         <a class="sidebar-brand" href="/">
           Laketower
         </a>
-        <button type="button" class="btn-close d-md-none" data-bs-dismiss="offcanvas" aria-label="Close" data-bs-target="#sidebar"></button>
+        <button
+          type="button"
+          class="btn-close d-md-none"
+          data-bs-dismiss="offcanvas"
+          aria-label="Close"
+          data-bs-target="#sidebar"
+        >
+        </button>
       </div>
       <div class="offcanvas-body">
         <ul class="sidebar-nav">
@@ -30,12 +37,36 @@
           {% for table in tables %}
           {% set table_url = '/tables/' + table.name %}
           <li class="nav-item">
-            <a class="nav-link{% if request.url.path.startswith(table_url) %} active{% endif %}" href="{{ table_url }}" aria-current="page">
+            <a
+              class="text-truncate nav-link{% if request.url.path.startswith(table_url) %} active{% endif %}"
+              href="{{ table_url }}"
+              aria-current="page"
+            >
               <i class="bi-table" aria-hidden="true"></i>
               {{ table.name }}
             </a>
           </li>
           {% endfor %}
+
+          <li><hr class="sidebar-divider"></li>
+
+          <li>
+            <h6 class="sidebar-header">Queries</h6>
+          </li>
+          <li><hr class="sidebar-divider"></li>
+          {% for query in queries %}
+          {% set query_url = '/queries/' + query.name + '/view' %}
+          <li class="nav-item">
+            <a
+              class="text-truncate nav-link{% if request.url.path.startswith(query_url) %} active{% endif %}"
+              href="{{ query_url }}"
+              aria-current="page"
+            >
+              <i class="bi-code-square" aria-hidden="true"></i>
+              {{ query.title }}
+            </a>
+          </li>
+          {% endfor %}
         </ul>
       </div>
     </nav>