laketower 0.1.0__tar.gz → 0.2.0__tar.gz

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

@@ -151,10 +151,10 @@ jobs:
         with:
           repository-url: https://test.pypi.org/legacy/
           skip-existing: true
-      - name: Install uv
-        uses: astral-sh/setup-uv@v5
-      - name: Validate package is available with uvx
-        run: uvx --index https://test.pypi.org/simple/ --index-strategy unsafe-best-match laketower --version
+      # - name: Install uv
+      #   uses: astral-sh/setup-uv@v5
+      # - name: Validate package is available with uvx
+      #   run: uvx --index https://test.pypi.org/simple/ --index-strategy unsafe-best-match laketower --version
 
   pypi-publish:
     name: Upload release to PyPI
@@ -178,3 +178,41 @@ jobs:
         uses: astral-sh/setup-uv@v5
       - name: Validate package is available with uvx
         run: uvx laketower --version
+
+  release-publish:
+    name: Publish release as GitHub Release
+    runs-on: ubuntu-latest
+    needs: build
+    if: ${{ contains(github.ref, 'tags') }}
+    env:
+      TAG_NAME: "${{ github.ref_name }}"
+      RELEASE_NOTES_MD_FILE: "release_notes.md"
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v4
+      - name: Download package build artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: build
+          path: dist/
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          python-version: '3.13'
+          enable-cache: true
+          cache-dependency-glob: "uv.lock"
+      - name: Extract changelog notes
+        run: |
+          uvx keepachangelog show ${TAG_NAME} >> "${RELEASE_NOTES_MD_FILE}"
+          cat "${RELEASE_NOTES_MD_FILE}" >> "${GITHUB_STEP_SUMMARY}"
+      - name: Create GitHub Release from changelog
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          gh release create "${TAG_NAME}" \
+            --repo "${GITHUB_REPOSITORY}" \
+            --title "${TAG_NAME}" \
+            --notes-file "${RELEASE_NOTES_MD_FILE}" \
+            --verify-tag \
+            dist/*

laketower-0.2.0/CHANGELOG.md

@@ -0,0 +1,42 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.2.0] - 2025-02-25
+Introducing the Laketower web application!
+
+### Added
+- `web` module
+    - List all registered tables
+    - Display table overview (metadata and schema)
+    - Display table history
+    - View a given table with simple query builder
+    - Query all registered tables with DuckDB SQL dialect
+- CLI: add `tables view --version` argument to time-travel table version
+
+### Fixed
+- Delta tables metadata compatibility when name and/or description is missing
+- Delta tables history compatibility when created with Spark
+- CLI: show default argument values in help
+
+## [0.1.0] - 2025-02-15
+Initial release of `laketower`.
+
+### Added
+- `cli` module
+    - Validate YAML configuration
+    - List all registered tables
+    - Display a given table metadata
+    - Display a given table schema
+    - Display a given table history
+    - 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
+[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.1.0/README.md → laketower-0.2.0/PKG-INFO

@@ -1,10 +1,50 @@
+Metadata-Version: 2.4
+Name: laketower
+Version: 0.2.0
+Summary: Oversee your lakehouse
+Project-URL: Repository, https://github.com/datalpia/laketower
+Project-URL: Issues, https://github.com/datalpia/laketower/issues
+Project-URL: Changelog, https://github.com/datalpia/laketower/blob/master/CHANGELOG.md
+Author-email: Romain Clement <git@romain-clement.net>
+License: AGPL-3.0-or-later
+License-File: LICENSE.md
+Keywords: data,delta-lake,lakehouse,sql
+Classifier: Development Status :: 2 - Pre-Alpha
+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
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Database
+Classifier: Topic :: Software Development
+Classifier: Topic :: Utilities
+Requires-Python: <3.14,>=3.9
+Requires-Dist: deltalake
+Requires-Dist: duckdb
+Requires-Dist: fastapi
+Requires-Dist: jinja2>=3
+Requires-Dist: pandas
+Requires-Dist: pyarrow!=19.0.0
+Requires-Dist: pydantic-settings>=2
+Requires-Dist: pydantic>=2
+Requires-Dist: pyyaml
+Requires-Dist: rich
+Requires-Dist: sqlglot
+Requires-Dist: uvicorn
+Description-Content-Type: text/markdown
+
 # Laketower
 
 > Oversee your lakehouse
 
 [![PyPI](https://img.shields.io/pypi/v/laketower.svg)](https://pypi.org/project/laketower/)
+[![Python Versions](https://img.shields.io/pypi/pyversions/laketower?logo=python&logoColor=white)](https://pypi.org/project/laketower/)
 [![CI/CD](https://github.com/datalpia/laketower/actions/workflows/ci-cd.yml/badge.svg)](https://github.com/datalpia/laketower/actions/workflows/ci-cd.yml)
-[![License](https://img.shields.io/github/license/datalpia/laketower)](https://github.com/datalpia/laketower/blob/main/LICENSE)
+[![License](https://img.shields.io/github/license/datalpia/laketower)](https://github.com/datalpia/laketower/blob/main/LICENSE.md)
 
 Utility application to explore and manage tables in your data lakehouse, especially tailored for data pipelines local development.
 
@@ -17,6 +57,7 @@ Utility application to explore and manage tables in your data lakehouse, especia
 - View table content with a simple query builder
 - Query all registered tables with DuckDB SQL dialect
 - Static and versionable YAML configuration
+- Web application
 - CLI application
 
 ## Installation
@@ -67,21 +108,30 @@ tables:
     format: delta
 ```
 
+### Web Application
+
+The easiest way to get started is to launch the Laketower web application:
+
+```bash
+$ laketower -c demo/laketower.yml web
+```
+
 ### CLI
 
 Laketower provides a CLI interface:
 
 ```bash
 $ laketower --help
-usage: laketower [-h] [--version] [--config CONFIG] {config,tables} ...
+usage: laketower [-h] [--version] [--config CONFIG] {web,config,tables} ...
 
 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
+  --config, -c CONFIG  Path to the Laketower YAML configuration file (default: laketower.yml)
 
 commands:
-  {config,tables}
+  {web,config,tables}
+    web                Launch the web application
     config             Work with configuration
     tables             Work with tables
 ```
@@ -205,6 +255,7 @@ Optional arguments:
 - `--sort-asc <col>`: sort by a column name in ascending order
 - `--sort-desc <col>`: sort by a column name in descending order
 - `--limit <num>` (default 10): limit the number of rows
+- `--version`: time-travel to table revision number
 
 ```bash
 $ laketower -c demo/laketower.yml tables view weather
@@ -239,6 +290,26 @@ $ laketower -c demo/laketower.yml tables view weather --cols time city temperatu
 └───────────────────────────┴──────────┴───────────────────┘
 ```
 
+```bash
+$ laketower -c demo/laketower.yml tables view weather --version 1
+
+┏━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━┓
+┃ time                      ┃ city     ┃ temperature_2m    ┃ relative_humidity_2m ┃ wind_speed_10m     ┃
+┡━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━┩
+│ 2025-01-26 01:00:00+01:00 │ Grenoble │ 7.0               │ 87.0                 │ 8.899999618530273  │
+│ 2025-01-26 02:00:00+01:00 │ Grenoble │ 6.099999904632568 │ 87.0                 │ 6.199999809265137  │
+│ 2025-01-26 03:00:00+01:00 │ Grenoble │ 6.0               │ 86.0                 │ 2.700000047683716  │
+│ 2025-01-26 04:00:00+01:00 │ Grenoble │ 6.099999904632568 │ 82.0                 │ 3.0999999046325684 │
+│ 2025-01-26 05:00:00+01:00 │ Grenoble │ 5.5               │ 87.0                 │ 3.299999952316284  │
+│ 2025-01-26 06:00:00+01:00 │ Grenoble │ 5.199999809265137 │ 91.0                 │ 2.200000047683716  │
+│ 2025-01-26 07:00:00+01:00 │ Grenoble │ 4.800000190734863 │ 86.0                 │ 3.0                │
+│ 2025-01-26 08:00:00+01:00 │ Grenoble │ 4.900000095367432 │ 83.0                 │ 1.100000023841858  │
+│ 2025-01-26 09:00:00+01:00 │ Grenoble │ 4.0               │ 92.0                 │ 3.0999999046325684 │
+│ 2025-01-26 10:00:00+01:00 │ Grenoble │ 5.0               │ 86.0                 │ 6.400000095367432  │
+└───────────────────────────┴──────────┴───────────────────┴──────────────────────┴────────────────────┘
+```
+
+
 #### Query all registered tables
 
 Query any registered tables using DuckDB SQL dialect!

laketower-0.1.0/PKG-INFO → laketower-0.2.0/README.md

@@ -1,33 +1,11 @@
-Metadata-Version: 2.4
-Name: laketower
-Version: 0.1.0
-Summary: Oversee your lakehouse
-Author-email: Romain Clement <git@romain-clement.net>
-License: AGPL-3.0-or-later
-License-File: LICENSE.md
-Classifier: Development Status :: 2 - Pre-Alpha
-Classifier: Intended Audience :: Developers
-Classifier: Intended Audience :: Information Technology
-Classifier: Topic :: Software Development
-Classifier: Topic :: Utilities
-Requires-Python: <3.14,>=3.9
-Requires-Dist: deltalake
-Requires-Dist: duckdb
-Requires-Dist: pandas
-Requires-Dist: pyarrow<19
-Requires-Dist: pydantic
-Requires-Dist: pyyaml
-Requires-Dist: rich
-Requires-Dist: sqlglot
-Description-Content-Type: text/markdown
-
 # Laketower
 
 > Oversee your lakehouse
 
 [![PyPI](https://img.shields.io/pypi/v/laketower.svg)](https://pypi.org/project/laketower/)
+[![Python Versions](https://img.shields.io/pypi/pyversions/laketower?logo=python&logoColor=white)](https://pypi.org/project/laketower/)
 [![CI/CD](https://github.com/datalpia/laketower/actions/workflows/ci-cd.yml/badge.svg)](https://github.com/datalpia/laketower/actions/workflows/ci-cd.yml)
-[![License](https://img.shields.io/github/license/datalpia/laketower)](https://github.com/datalpia/laketower/blob/main/LICENSE)
+[![License](https://img.shields.io/github/license/datalpia/laketower)](https://github.com/datalpia/laketower/blob/main/LICENSE.md)
 
 Utility application to explore and manage tables in your data lakehouse, especially tailored for data pipelines local development.
 
@@ -40,6 +18,7 @@ Utility application to explore and manage tables in your data lakehouse, especia
 - View table content with a simple query builder
 - Query all registered tables with DuckDB SQL dialect
 - Static and versionable YAML configuration
+- Web application
 - CLI application
 
 ## Installation
@@ -90,21 +69,30 @@ tables:
     format: delta
 ```
 
+### Web Application
+
+The easiest way to get started is to launch the Laketower web application:
+
+```bash
+$ laketower -c demo/laketower.yml web
+```
+
 ### CLI
 
 Laketower provides a CLI interface:
 
 ```bash
 $ laketower --help
-usage: laketower [-h] [--version] [--config CONFIG] {config,tables} ...
+usage: laketower [-h] [--version] [--config CONFIG] {web,config,tables} ...
 
 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
+  --config, -c CONFIG  Path to the Laketower YAML configuration file (default: laketower.yml)
 
 commands:
-  {config,tables}
+  {web,config,tables}
+    web                Launch the web application
     config             Work with configuration
     tables             Work with tables
 ```
@@ -228,6 +216,7 @@ Optional arguments:
 - `--sort-asc <col>`: sort by a column name in ascending order
 - `--sort-desc <col>`: sort by a column name in descending order
 - `--limit <num>` (default 10): limit the number of rows
+- `--version`: time-travel to table revision number
 
 ```bash
 $ laketower -c demo/laketower.yml tables view weather
@@ -262,6 +251,26 @@ $ laketower -c demo/laketower.yml tables view weather --cols time city temperatu
 └───────────────────────────┴──────────┴───────────────────┘
 ```
 
+```bash
+$ laketower -c demo/laketower.yml tables view weather --version 1
+
+┏━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━┓
+┃ time                      ┃ city     ┃ temperature_2m    ┃ relative_humidity_2m ┃ wind_speed_10m     ┃
+┡━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━┩
+│ 2025-01-26 01:00:00+01:00 │ Grenoble │ 7.0               │ 87.0                 │ 8.899999618530273  │
+│ 2025-01-26 02:00:00+01:00 │ Grenoble │ 6.099999904632568 │ 87.0                 │ 6.199999809265137  │
+│ 2025-01-26 03:00:00+01:00 │ Grenoble │ 6.0               │ 86.0                 │ 2.700000047683716  │
+│ 2025-01-26 04:00:00+01:00 │ Grenoble │ 6.099999904632568 │ 82.0                 │ 3.0999999046325684 │
+│ 2025-01-26 05:00:00+01:00 │ Grenoble │ 5.5               │ 87.0                 │ 3.299999952316284  │
+│ 2025-01-26 06:00:00+01:00 │ Grenoble │ 5.199999809265137 │ 91.0                 │ 2.200000047683716  │
+│ 2025-01-26 07:00:00+01:00 │ Grenoble │ 4.800000190734863 │ 86.0                 │ 3.0                │
+│ 2025-01-26 08:00:00+01:00 │ Grenoble │ 4.900000095367432 │ 83.0                 │ 1.100000023841858  │
+│ 2025-01-26 09:00:00+01:00 │ Grenoble │ 4.0               │ 92.0                 │ 3.0999999046325684 │
+│ 2025-01-26 10:00:00+01:00 │ Grenoble │ 5.0               │ 86.0                 │ 6.400000095367432  │
+└───────────────────────────┴──────────┴───────────────────┴──────────────────────┴────────────────────┘
+```
+
+
 #### Query all registered tables
 
 Query any registered tables using DuckDB SQL dialect!

laketower-0.2.0/laketower/__about__.py

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

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

@@ -1,178 +1,24 @@
 from __future__ import annotations
 
 import argparse
-import enum
-from datetime import datetime, timezone
+import os
 from pathlib import Path
-from typing import Any
 
-import deltalake
-import duckdb
-import pandas as pd
-import pyarrow as pa
-import pydantic
+import rich.jupyter
 import rich.panel
 import rich.table
 import rich.text
 import rich.tree
-import sqlglot
-import sqlglot.dialects
-import sqlglot.dialects.duckdb
-import sqlglot.generator
-import yaml
+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
 
 
-class TableFormats(str, enum.Enum):
-    delta = "delta"
-
-
-class ConfigTable(pydantic.BaseModel):
-    name: str
-    uri: str
-    table_format: TableFormats = pydantic.Field(alias="format")
-
-    @pydantic.model_validator(mode="after")
-    def check_table(self) -> "ConfigTable":
-        def check_delta_table(table_uri: str) -> None:
-            if not deltalake.DeltaTable.is_deltatable(table_uri):
-                raise ValueError(f"{table_uri} is not a valid Delta table")
-
-        format_check = {TableFormats.delta: check_delta_table}
-        format_check[self.table_format](self.uri)
-
-        return self
-
-
-class ConfigQuery(pydantic.BaseModel):
-    name: str
-    sql: str
-
-
-class ConfigDashboard(pydantic.BaseModel):
-    name: str
-
-
-class Config(pydantic.BaseModel):
-    tables: list[ConfigTable] = []
-
-
-def load_yaml_config(config_path: Path) -> Config:
-    config_dict = yaml.safe_load(config_path.read_text())
-    return Config.model_validate(config_dict)
-
-
-class TableMetadata(pydantic.BaseModel):
-    table_format: TableFormats
-    name: str
-    description: str
-    uri: str
-    id: str
-    version: int
-    created_at: datetime
-    partitions: list[str]
-    configuration: dict[str, str]
-
-
-class TableRevision(pydantic.BaseModel):
-    version: int
-    timestamp: datetime
-    client_version: str
-    operation: str
-    operation_parameters: dict[str, Any]
-    operation_metrics: dict[str, Any]
-
-
-class TableHistory(pydantic.BaseModel):
-    revisions: list[TableRevision]
-
-
-def load_table_metadata(table_config: ConfigTable) -> TableMetadata:
-    def load_delta_table_metadata(table_config: ConfigTable) -> TableMetadata:
-        delta_table = deltalake.DeltaTable(table_config.uri)
-        metadata = delta_table.metadata()
-        return TableMetadata(
-            table_format=table_config.table_format,
-            name=metadata.name,
-            description=metadata.description,
-            uri=delta_table.table_uri,
-            id=str(metadata.id),
-            version=delta_table.version(),
-            created_at=datetime.fromtimestamp(
-                metadata.created_time / 1000, tz=timezone.utc
-            ),
-            partitions=metadata.partition_columns,
-            configuration=metadata.configuration,
-        )
-
-    format_handler = {TableFormats.delta: load_delta_table_metadata}
-    return format_handler[table_config.table_format](table_config)
-
-
-def load_table_schema(table_config: ConfigTable) -> pa.Schema:
-    def load_delta_table_schema(table_config: ConfigTable) -> pa.Schema:
-        delta_table = deltalake.DeltaTable(table_config.uri)
-        return delta_table.schema().to_pyarrow()
-
-    format_handler = {TableFormats.delta: load_delta_table_schema}
-    return format_handler[table_config.table_format](table_config)
-
-
-def load_table_history(table_config: ConfigTable) -> TableHistory:
-    def load_delta_table_history(table_config: ConfigTable) -> TableHistory:
-        delta_table = deltalake.DeltaTable(table_config.uri)
-        delta_history = delta_table.history()
-        revisions = [
-            TableRevision(
-                version=event["version"],
-                timestamp=datetime.fromtimestamp(
-                    event["timestamp"] / 1000, tz=timezone.utc
-                ),
-                client_version=event["clientVersion"],
-                operation=event["operation"],
-                operation_parameters=event["operationParameters"],
-                operation_metrics=event.get("operationMetrics") or {},
-            )
-            for event in delta_history
-        ]
-        return TableHistory(revisions=revisions)
-
-    format_handler = {TableFormats.delta: load_delta_table_history}
-    return format_handler[table_config.table_format](table_config)
-
-
-def load_table_dataset(table_config: ConfigTable) -> pa.dataset.Dataset:
-    def load_delta_table_metadata(table_config: ConfigTable) -> pa.dataset.Dataset:
-        delta_table = deltalake.DeltaTable(table_config.uri)
-        return delta_table.to_pyarrow_dataset()
-
-    format_handler = {TableFormats.delta: load_delta_table_metadata}
-    return format_handler[table_config.table_format](table_config)
-
-
-def execute_query_table(table_config: ConfigTable, sql_query: str) -> pd.DataFrame:
-    table_dataset = load_table_dataset(table_config)
-    table_name = table_config.name
-    view_name = f"{table_name}_view"
-    conn = duckdb.connect()
-    conn.register(view_name, table_dataset)
-    conn.execute(f"create table {table_name} as select * from {view_name}")  # nosec B608
-    return conn.execute(sql_query).df()
-
-
-def execute_query(tables_config: list[ConfigTable], sql_query: str) -> pd.DataFrame:
-    try:
-        conn = duckdb.connect()
-        for table_config in tables_config:
-            table_dataset = load_table_dataset(table_config)
-            table_name = table_config.name
-            view_name = f"{table_name}_view"
-            conn.register(view_name, table_dataset)
-            conn.execute(f"create table {table_name} as select * from {view_name}")  # nosec B608
-        return conn.execute(sql_query).df()
-    except duckdb.Error as e:
-        raise ValueError(str(e)) from e
+def run_web(config_path: Path, reload: bool) -> None:  # pragma: no cover
+    os.environ["LAKETOWER_CONFIG_PATH"] = str(config_path.absolute())
+    uvicorn.run("laketower.web:create_app", factory=True, reload=reload)
 
 
 def validate_config(config_path: Path) -> None:
@@ -200,7 +46,8 @@ def list_tables(config_path: Path) -> None:
 def table_metadata(config_path: Path, table_name: str) -> None:
     config = load_yaml_config(config_path)
     table_config = next(filter(lambda x: x.name == table_name, config.tables))
-    metadata = load_table_metadata(table_config)
+    table = load_table(table_config)
+    metadata = table.metadata()
 
     tree = rich.tree.Tree(table_name)
     tree.add(f"name: {metadata.name}")
@@ -219,7 +66,8 @@ def table_metadata(config_path: Path, table_name: str) -> None:
 def table_schema(config_path: Path, table_name: str) -> None:
     config = load_yaml_config(config_path)
     table_config = next(filter(lambda x: x.name == table_name, config.tables))
-    schema = load_table_schema(table_config)
+    table = load_table(table_config)
+    schema = table.schema()
 
     tree = rich.tree.Tree(table_name)
     for field in schema:
@@ -232,7 +80,8 @@ def table_schema(config_path: Path, table_name: str) -> None:
 def table_history(config_path: Path, table_name: str) -> None:
     config = load_yaml_config(config_path)
     table_config = next(filter(lambda x: x.name == table_name, config.tables))
-    history = load_table_history(table_config)
+    table = load_table(table_config)
+    history = table.history()
 
     tree = rich.tree.Tree(table_name)
     for rev in history.revisions:
@@ -257,22 +106,21 @@ def view_table(
     cols: list[str] | None = None,
     sort_asc: str | None = None,
     sort_desc: str | None = None,
+    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_query(
+        table_name, limit=limit, cols=cols, sort_asc=sort_asc, sort_desc=sort_desc
+    )
+    results = execute_query({table_name: table_dataset}, sql_query)
 
-    query_expr = sqlglot.select(*(cols or ["*"])).from_(table_name).limit(limit or 10)
-    if sort_asc:
-        query_expr = query_expr.order_by(f"{sort_asc} asc")
-    elif sort_desc:
-        query_expr = query_expr.order_by(f"{sort_desc} desc")
-    sql_query = sqlglot.Generator(dialect=sqlglot.dialects.DuckDB).generate(query_expr)
-
-    results = execute_query_table(table_config, sql_query)
     out = rich.table.Table()
     for column in results.columns:
         out.add_column(column)
-    for value_list in results.values.tolist():
+    for value_list in results.to_numpy().tolist():
         row = [str(x) for x in value_list]
         out.add_row(*row)
 
@@ -282,10 +130,14 @@ def view_table(
 
 def query_table(config_path: Path, sql_query: str) -> None:
     config = load_yaml_config(config_path)
+    tables_dataset = {
+        table_config.name: load_table(table_config).dataset()
+        for table_config in config.tables
+    }
 
     out: rich.jupyter.JupyterMixin
     try:
-        results = execute_query(config.tables, sql_query)
+        results = execute_query(tables_dataset, sql_query)
         out = rich.table.Table()
         for column in results.columns:
             out.add_column(column)
@@ -300,7 +152,9 @@ def query_table(config_path: Path, sql_query: str) -> None:
 
 
 def cli() -> None:
-    parser = argparse.ArgumentParser("laketower")
+    parser = argparse.ArgumentParser(
+        "laketower", formatter_class=argparse.ArgumentDefaultsHelpFormatter
+    )
     parser.add_argument("--version", action="version", version=__version__)
     parser.add_argument(
         "--config",
@@ -311,6 +165,17 @@ def cli() -> None:
     )
     subparsers = parser.add_subparsers(title="commands", required=True)
 
+    parser_web = subparsers.add_parser(
+        "web", help="Launch the web application", add_help=True
+    )
+    parser_web.add_argument(
+        "--reload",
+        help="Reload the web server on changes",
+        action="store_true",
+        required=False,
+    )
+    parser_web.set_defaults(func=lambda x: run_web(x.config, x.reload))
+
     parser_config = subparsers.add_parser(
         "config", help="Work with configuration", add_help=True
     )
@@ -364,9 +229,12 @@ def cli() -> None:
     parser_tables_view_sort_group.add_argument(
         "--sort-desc", help="Sort by given column in descending order"
     )
+    parser_tables_view.add_argument(
+        "--version", type=int, help="Time-travel to table revision number"
+    )
     parser_tables_view.set_defaults(
         func=lambda x: view_table(
-            x.config, x.table, x.limit, x.cols, x.sort_asc, x.sort_desc
+            x.config, x.table, x.limit, x.cols, x.sort_asc, x.sort_desc, x.version
         )
     )