teridex 0.1.0__py3-none-any.whl

teridex-0.1.0.data/data/share/teridex/teridex.tcss

@@ -0,0 +1,210 @@
+/* Teridex Textual CSS — main layout
+ *
+ * Layout:
+ *   ┌── Data Catalog ────┐┌──── Query Editor ──────────────────┐
+ *   │ schema tree         ││  Tab 1  Tab 2                     │
+ *   │                     ││  SQL editor with line numbers      │
+ *   │                     │├───────────────────────────────────┤
+ *   │                     ││ Tx: Auto   Limit 500  [Run Query] │
+ *   │                     │├──── Query Results ────────────────┤
+ *   │                     ││  data table                       │
+ *   └─────────────────────┘└───────────────────────────────────┘
+ *   ^q Quit  f1 Help  ^↵ Run Query  ^r Refresh  ... (footer)
+ */
+
+Screen {
+    background: $background;
+    color: $foreground;
+}
+
+/* ── Top-level wrapper ── */
+MainScreen {
+    height: 100%;
+    width: 100%;
+    layout: vertical;
+}
+
+/* ── 2-column grid: sidebar | workspace ── */
+#main-grid {
+    layout: grid;
+    grid-size: 2 1;
+    grid-columns: 28 1fr;
+    grid-rows: 1fr;
+    height: 1fr;
+    width: 100%;
+}
+
+/* Dynamic plugin rails (preserve existing behaviour) */
+#main-grid.with-right {
+    grid-size: 3 1;
+    grid-columns: 28 1fr auto;
+}
+
+/* ── Sidebar: "Data Catalog" ── */
+#sidebar {
+    border: round $primary;
+    border-title-align: left;
+    border-title-color: $foreground;
+    border-title-style: bold;
+    padding: 0 1;
+    overflow-y: auto;
+}
+
+/* ── Right workspace ── */
+#workspace {
+    layout: vertical;
+    height: 100%;
+}
+
+/* ── Query Editor panel ── */
+#editor-panel {
+    border: round $primary;
+    border-title-align: left;
+    border-title-color: $foreground;
+    border-title-style: bold;
+    height: 2fr;
+    min-height: 8;
+}
+
+/* ── Action bar between editor and results ── */
+#action-bar {
+    height: 1;
+    background: $surface;
+    layout: horizontal;
+    padding: 0 1;
+}
+
+#action-bar .action-label {
+    width: auto;
+    color: $foreground;
+    padding: 0 1;
+}
+
+#action-bar #run-query-btn {
+    dock: right;
+    min-width: 14;
+    background: $primary;
+    color: $background;
+    text-style: bold;
+    padding: 0 1;
+}
+
+/* ── Query Results panel ── */
+#results-panel {
+    border: round $primary;
+    border-title-align: left;
+    border-title-color: $foreground;
+    border-title-style: bold;
+    height: 1fr;
+    min-height: 4;
+}
+
+/* ── Plugin rails ── */
+#right-rail {
+    width: 30;
+    border: round $primary 50%;
+    padding: 0 1;
+}
+
+#bottom-rail {
+    column-span: 2;
+    height: 10;
+    border-top: solid $primary 50%;
+    padding: 0 1;
+}
+
+#main-grid.with-right #bottom-rail {
+    column-span: 3;
+}
+
+/* ── Footer status bar — yellow/gold with keybinding shortcuts ── */
+#status-bar {
+    height: 1;
+    background: $warning;
+    color: $background;
+    padding: 0 1;
+    text-style: bold;
+    dock: bottom;
+    width: 100%;
+}
+
+/* ── Widget-level styles ── */
+
+SchemaTree {
+    height: 100%;
+}
+
+/* TabbedContent inside the editor panel */
+#query-tabs {
+    height: 100%;
+}
+
+SqlEditor {
+    height: 100%;
+}
+
+ResultsTable {
+    height: 100%;
+}
+
+/* ── Command Palette overlay ── */
+CommandPalette {
+    layer: overlay;
+    align: center top;
+    width: 70%;
+    height: auto;
+    border: thick $accent;
+    background: $surface;
+    padding: 1;
+    margin-top: 4;
+}
+
+#palette-input {
+    height: 3;
+    border: round $primary;
+}
+
+#palette-list {
+    height: 12;
+    border: round $primary;
+}
+
+/* ── Help, History & Connection modals ── */
+#HelpModal,
+#HistoryModal,
+#ConnectionModal {
+    align: center middle;
+    background: $surface;
+    border: thick $accent;
+    width: 80%;
+    max-width: 100;
+    height: 60%;
+    max-height: 28;
+    padding: 1 2;
+}
+
+#history-list {
+    height: 1fr;
+    border: round $primary;
+}
+
+#conn-input {
+    height: 3;
+    border: round $primary;
+    margin-bottom: 1;
+}
+
+#conn-presets {
+    height: 6;
+    border: round $primary;
+    margin-bottom: 1;
+    background: $surface;
+}
+
+#conn-submit-btn {
+    dock: bottom;
+    min-width: 14;
+    background: $primary;
+    color: $background;
+    text-style: bold;
+}

teridex-0.1.0.dist-info/METADATA

@@ -0,0 +1,262 @@
+Metadata-Version: 2.4
+Name: teridex
+Version: 0.1.0
+Summary: A terminal-native database IDE. Keyboard-first, async, pluggable.
+Author: Teridex contributors
+License: MIT
+License-File: LICENSE
+Requires-Python: >=3.13
+Requires-Dist: aiosqlite>=0.20
+Requires-Dist: pydantic-settings>=2.6
+Requires-Dist: pydantic>=2.9
+Requires-Dist: rapidfuzz>=3.10
+Requires-Dist: rich>=13.7
+Requires-Dist: sqlalchemy>=2.0
+Requires-Dist: structlog>=24.4
+Requires-Dist: textual>=0.83
+Requires-Dist: typer>=0.12
+Requires-Dist: typing-extensions>=4.12
+Provides-Extra: all
+Requires-Dist: aiosqlite>=0.20; extra == 'all'
+Requires-Dist: asyncmy2>=0.2.20; extra == 'all'
+Requires-Dist: asyncpg>=0.29; extra == 'all'
+Requires-Dist: cryptography>=42.0; extra == 'all'
+Requires-Dist: duckdb>=1.1; extra == 'all'
+Provides-Extra: duckdb
+Requires-Dist: duckdb>=1.1; extra == 'duckdb'
+Provides-Extra: mysql
+Requires-Dist: asyncmy2>=0.2.20; extra == 'mysql'
+Requires-Dist: cryptography>=42.0; extra == 'mysql'
+Provides-Extra: postgres
+Requires-Dist: asyncpg>=0.29; extra == 'postgres'
+Provides-Extra: sqlite
+Requires-Dist: aiosqlite>=0.20; extra == 'sqlite'
+Description-Content-Type: text/markdown
+
+# Teridex 📟
+
+**A terminal-native database IDE. Keyboard-first, async, pluggable.**
+
+Teridex is a TUI database client built on a clean async core and a plugin-first architecture. It combines a rich query editor, lazy schema browser, virtualized result tables, and a fuzzy command palette — all inside your terminal.
+
+---
+
+## ✨ Key Features
+
+*   **⚡ Asynchronous Execution**: Multi-threaded, fully cancellable database queries. Long-running queries won't block the TUI layout or cursor.
+*   **⌨️ Keyboard-First Design**: Optimized for hands-on-keyboard speed. Support for both standard and Vim-style keybindings.
+*   **🔌 Pluggable Architecture**: Easily write plugins to add custom panels, new commands to the palette, or listen to event hooks.
+*   **🗃️ Built-in Database Drivers**: First-class support for **DuckDB**, **SQLite**, **PostgreSQL**, and **MySQL**.
+*   **📝 Rich Workspace Layout**:
+    *   **Live Schema Tree**: Real-time introspection of schemas, tables, columns, indexes, and foreign keys.
+    *   **Multi-Tab SQL Editor**: Edit multiple queries side-by-side with SQL syntax highlighting.
+    *   **Interactive Results Table**: Search, filter, and scroll through large result sets cleanly using pagination/batch loading.
+    *   **Command Palette**: Quick actions, screen switching, and plugin commands.
+*   **⚙️ Configuration Layer**: Customize the look and feel (including Monokai and Nord themes) and define saved connections.
+
+---
+
+## 📐 Package Architecture & Layering
+
+Teridex follows a clean, layered architecture with strict dependency boundaries:
+
+```mermaid
+graph TD
+    core["teridex-core (Pure Domain)"]
+    adapters["teridex-adapters (DB Drivers)"]
+    plugins["teridex-plugins (Plugin API)"]
+    engine["teridex-engine (Orchestration)"]
+    tui["teridex-tui (Textual TUI)"]
+    cli["teridex-cli (Typer CLI)"]
+
+    adapters --> core
+    plugins --> core
+    engine --> adapters
+    engine --> plugins
+    tui --> engine
+    cli --> engine
+```
+
+> [!IMPORTANT]
+> **Dependency Isolation**: Inner packages must never depend on outer packages. Specifically, `teridex_core` has no dependencies on any other internal package. These boundaries are strictly verified via `mypy --strict`.
+
+---
+
+## 🚀 Getting Started
+
+### Prerequisites
+
+*   **Python >= 3.13**
+*   The [**`uv`**](https://docs.astral.sh/uv/) package manager (recommended) or standard `pip`.
+
+### Installation
+
+Install Teridex using `uv` or standard Python package managers:
+
+```bash
+# Install core package
+pip install teridex
+
+# Install with support for all database drivers (Postgres, MySQL, SQLite, DuckDB)
+pip install "teridex[all]"
+
+# Install with specific drivers
+pip install "teridex[postgres]"
+pip install "teridex[duckdb]"
+```
+
+Alternatively, clone the repository for local development:
+
+```bash
+git clone https://github.com/salvatorecorvaglia/teridex.git
+cd teridex
+./scripts/dev.sh
+```
+
+### Running the TUI
+
+Start the workspace by pointing it to a database DSN (Data Source Name):
+
+```bash
+# Open with a temporary in-memory DuckDB
+teridex tui --dsn duckdb:///:memory:
+
+# Connect to a local SQLite database file
+teridex tui --dsn sqlite:///path/to/database.db
+
+# Connect to a PostgreSQL instance
+teridex tui --dsn postgresql://user:password@localhost:5432/mydatabase
+```
+
+### One-Shot CLI Execution
+
+Run query statements directly from the command line and view results rendered as a styled table:
+
+```bash
+teridex run --dsn duckdb:///:memory: "SELECT 'Hello, Teridex!' AS message"
+```
+
+---
+
+## ⚙️ Configuration
+
+Configure Teridex via the config file located at `~/.config/teridex/config.toml`. 
+
+Refer to the [config.example.toml](file:///Users/salvatorecorvaglia/github/teridex/config.example.toml) file for available options:
+
+```toml
+[ui]
+theme = "monokai"       # "monokai" (warm) or "nord" (cool)
+keymap = "default"      # "default" or "vim"
+show_status_bar = true
+row_batch_size = 1000   # Rows per batch to fetch from adapters
+
+[engine]
+default_timeout_seconds = 60.0
+max_history_entries = 1000
+pool_size = 5
+
+[logging]
+level = "INFO"
+
+[plugins]
+enabled = []            # Specify IDs of plugins to load (empty loader registers all)
+disabled = []           # Specify IDs of plugins to exclude
+```
+
+### Environment Overrides
+You can override configuration keys using environment variables using the structure: `TERIDEX_<SECTION>__<FIELD>`.
+For example:
+```bash
+TERIDEX_UI__THEME=nord teridex tui
+```
+
+---
+
+## 🔌 Extensibility: Writing Plugins
+
+Plugins are discovered using Python entry points registered under the `teridex.plugins` group in your package's metadata. 
+
+A plugin needs to implement the [Plugin](file:///Users/salvatorecorvaglia/github/teridex/src/teridex_core/protocols/plugin.py#L22-L29) protocol.
+
+### 1. Define the Manifest and Hooks
+
+Create a class with a `manifest` property, `on_load`, and `on_unload` methods:
+
+```python
+from teridex_plugins import PluginContext, Command, hook
+from teridex_core.protocols.plugin import PluginManifest
+
+class MyPlugin:
+    manifest = PluginManifest(
+        id="custom-notifier",
+        name="Custom Notifier",
+        version="0.1.0",
+        description="Warns users when executing risky SQL queries.",
+        requires_teridex=">=0.1.0"
+    )
+
+    def on_load(self, ctx: PluginContext) -> None:
+        # Register command palette action
+        ctx.register_command(
+            Command(
+                id="notify-hello",
+                title="Hello Notifier",
+                handler=self.hello_handler,
+                default_binding="ctrl+h"
+            )
+        )
+        ctx.logger.info("Custom Notifier plugin successfully loaded!")
+
+    def on_unload(self, ctx: PluginContext) -> None:
+        ctx.logger.info("Custom Notifier plugin unloaded.")
+
+    async def hello_handler(self, ctx: PluginContext) -> None:
+        ctx.publish(SomeNotificationEvent("Hello from plugin!"))
+
+    @hook("query.before_execute")
+    async def warn_on_drop(self, ctx: PluginContext, sql: str) -> None:
+        if "drop table" in sql.lower():
+            ctx.logger.warning("Risky query detected!", sql=sql)
+```
+
+Refer to [api.py](file:///Users/salvatorecorvaglia/github/teridex/src/teridex_plugins/api.py) and [context.py](file:///Users/salvatorecorvaglia/github/teridex/src/teridex_plugins/context.py) for the complete plugin-facing API surface.
+
+---
+
+## 🛠️ Extensibility: Custom Database Adapters
+
+Add adapters by subclassing [AbstractAdapter](file:///Users/salvatorecorvaglia/github/teridex/src/teridex_adapters/base.py#L45-L161):
+
+1. Subclass `AbstractAdapter` and set the driver names and URL schemas.
+2. Implement `_do_connect`, `_do_close`, `ping`, `execute`, `stream`, `begin`, and `introspect`.
+3. Register your driver class in [registry.py](file:///Users/salvatorecorvaglia/github/teridex/src/teridex_adapters/registry.py).
+
+---
+
+## 🛠️ Local Development & Testing
+
+We provide helper scripts inside the `scripts/` directory to run checks, tests, and formatting easily:
+
+*   **Run All Quality Gates**: `./scripts/check.sh` (Runs linting, typing, formatting, and unit tests).
+*   **Format Code**: `./scripts/fmt.sh` (Using Ruff).
+*   **Lint & Type Checking**: `./scripts/lint.sh` (Ruff and Mypy strict).
+*   **Unit Tests**: `./scripts/test.sh` (Pytest).
+
+---
+
+## 🤝 Contributing
+
+Contributions are welcome! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+
+## 🔐 Security
+
+If you discover a security vulnerability, please see our [Security Policy](SECURITY.md).
+
+## 📝 License
+
+Distributed under the MIT License. See [LICENSE](LICENSE) for more information.
+
+---
+
+**Author**: [Salvatore Corvaglia](https://github.com/salvatorecorvaglia)

teridex-0.1.0.dist-info/RECORD

@@ -0,0 +1,76 @@
+teridex_adapters/__init__.py,sha256=sC2NHGhNZRsCAQkGcIuQ3jVowiPqymWZfoiY4_D3Mtg,370
+teridex_adapters/_introspect.py,sha256=wxCwlCo7JUywr5l8YzyTmBgDo4azQmcbIj5GqxGh-MU,3089
+teridex_adapters/_typeinfer.py,sha256=kBICSsg4wVWjwqJvEM-LLdabpxJkds7W4jq8ZlYGh1A,1678
+teridex_adapters/base.py,sha256=coUKPfDHtzgQal76OES7aWVYsJ0FSBn641n6j3NpPSk,5326
+teridex_adapters/duckdb_adapter.py,sha256=obc7tbMBFd2YEAjMRpyyzfbqK7Ecfj3NjSfoapWlA3s,11066
+teridex_adapters/mysql_adapter.py,sha256=BnwYx1eMobruNrFU5W2_3-gF8j-iuaSV9MA_Leyl1pY,14478
+teridex_adapters/postgres_adapter.py,sha256=XuOpb6_NSsbNi82LPOe0-DLDQmCZnBWtCInojV2CAYQ,16411
+teridex_adapters/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+teridex_adapters/registry.py,sha256=HTtM5W9NTP3qttbDsKLamZEArqEqvENvORtT0HGWLQ4,3185
+teridex_adapters/sqlite_adapter.py,sha256=NcIY2mNlfbz2XU9AKISq0aCCAQ2xzjWtFAfHR59nlq0,11156
+teridex_cli/__init__.py,sha256=bPJlQpC7TlrefRpqd-lb12CWiC-XuzjK-dB2ZjWeN0g,86
+teridex_cli/__main__.py,sha256=ak8uVvx3Dew9XrnfC_MWL1L22xeboqrapeymZAfNDfI,73
+teridex_cli/main.py,sha256=zwRCJrhYFNKcXhbI3OQ4oWidw3X_wAA6-GdzZXRydug,7507
+teridex_cli/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+teridex_core/__init__.py,sha256=c0H0NUg0afTRHH_NQZ4a_uiLJOXtBrkp_Gd5t2b5jrw,425
+teridex_core/config.py,sha256=DjlYNKDOvEB-yDpS1te63aCKBJKybLNyIznangq4X8w,4594
+teridex_core/di.py,sha256=3X1pQzofiItHMPd0TAbWTs2Yn8lDhAWe1MsqumxB1u4,3222
+teridex_core/errors.py,sha256=0X4HBtAPmAHw3mMkbYxKY2tdocgPc7m7f3MaR3Vv-RU,1857
+teridex_core/events.py,sha256=3EV5az1Hu8IvndcCrAqM1tYHpqbz0EvGRpyKLJGmqjc,8858
+teridex_core/logging.py,sha256=-2gYkTNP6D6BTdepPTzI2YA-ksPm22k3QKq16f3aKzw,3423
+teridex_core/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+teridex_core/result.py,sha256=s9UuZpmyg0pKO96mfPYr2Px_B9J6ANfRraPfvYc9UjY,1617
+teridex_core/models/__init__.py,sha256=od6eSMP1AQOaSVxOzo9KHghe6NkYe3ObrDM5VOA3j9g,671
+teridex_core/models/connection.py,sha256=h4ROfhGG0L_VjluOwFT1vLfquDJcgIc3Ag3jsh_z07g,3838
+teridex_core/models/query.py,sha256=6yvpR49KVXOxp1HXqCjfqPpjXjl7yFmLrAxdaRauetU,1841
+teridex_core/models/result.py,sha256=0ffv5iUkTd5PShzQXnX8Sl6YYMlOyS9_KAxTrqQuEYo,1077
+teridex_core/models/schema.py,sha256=mIJzZXyY5FZ5VXMPX_HDW0ONNNTwbZKPQmBGhqUxbp4,2003
+teridex_core/protocols/__init__.py,sha256=NIWFXulXkAadv4r2YnQHz8fWAIH9UNwWucxDzddz2Ow,313
+teridex_core/protocols/adapter.py,sha256=X-NsTTSIodacvVDOgMzJ4_D5eDk6SqSJ7GkcU2Ao9dY,2022
+teridex_core/protocols/plugin.py,sha256=aeacrZhJjYpXEgAgXhmpV9aZRfkDEnh90XcECeZN2Dc,627
+teridex_engine/__init__.py,sha256=XfQevS3y-46PZ7F7GM9-fD2-zAhuc_4zV32N2ujIoU4,369
+teridex_engine/executor.py,sha256=Frkc0KT4bjeuBRfapMXZKxQbCr0NSS3dpMFUnxfGbPc,5447
+teridex_engine/history.py,sha256=kF5q58UBTjXX2h4_OmPOWEFcod-2YH3WWjpJLbf1xtg,5002
+teridex_engine/introspector.py,sha256=VR6_sBgZTPIhWcR0gO_jbPcdL9cq5fN2WxBl39fTHto,2989
+teridex_engine/pool.py,sha256=uwCrBmLApPI2JgUV-uO2FvB_izjhUFWk6aze7-Qr_sc,7053
+teridex_engine/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+teridex_engine/transaction.py,sha256=38v3AzQXo4wbuiJgEnNXYWbx_pmJo--FkCFYso20tyY,718
+teridex_plugins/__init__.py,sha256=J9urJ7pXVsIyoXE1rILhdNYUFmIZX_UIqEJl3gWpQU0,386
+teridex_plugins/api.py,sha256=ur9iR9MUf7hgll11QqfoR2TUgacvActdPJy_yI0v8sk,2863
+teridex_plugins/context.py,sha256=RurREVHl8Cusb2tUDTNqrS_GMVqoDBM3yiQ6sMuj4do,2509
+teridex_plugins/loader.py,sha256=EAqq42PBo5vhkWdcdtaV0deHo1NhpCN6GNBsqhVnzvk,7291
+teridex_plugins/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+teridex_plugins/registry.py,sha256=L9TeDqPNvAvNhKDHt1LUtkb2UjZ11FUO6ORIlEX2ME4,3279
+teridex_tui/__init__.py,sha256=oFW7OHcjahBSD9Uil-UgzhVlS8MBtFGxemnItDsVD-U,93
+teridex_tui/app.py,sha256=j7RADqc_b2AqOM9hNjoi7R5gkujEM5ykNg8jzZA-8cA,21056
+teridex_tui/builtin_commands.py,sha256=-1mCnN-ql7rE2ExkNCxjQm30Wthsh0lb5YCeDvTT4KA,2894
+teridex_tui/events.py,sha256=U2AZ4In55CWy8jo53_HAKW2QK9XYLcaov0Z3MEoiSFw,211
+teridex_tui/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+teridex_tui/state.py,sha256=hFJdrY84TSPcMbLfl2fTBvbUKPsXqjRY2XIts5-fAlY,1287
+teridex_tui/keymaps/__init__.py,sha256=jm3T7oyv-eK0s0c25x4NEwM7bkHWMoOWRNfq9ktAfmg,177
+teridex_tui/keymaps/default.py,sha256=zzTqce8p14hLs5XTgyJoThpTL4F1qyVWB_WbdpptmIg,689
+teridex_tui/keymaps/vim.py,sha256=SIoaQlHZcztyUpIjD3fwSeH4oLhrb93Ob3i2k8dmiGU,391
+teridex_tui/screens/__init__.py,sha256=OmbfgnhDzzU-HwiB6lyZuMcXzDvGq1Zm0xXrprJAPxs,263
+teridex_tui/screens/command_palette.py,sha256=znJ-QLRPLPcX5Nz-rP5fafaJRoS3NVs6q6xP4sjoIsk,3142
+teridex_tui/screens/connection.py,sha256=vUX0DGyGJCAisFkFHnlLs0ucNBBSiIp3BHUgMnnRiBs,3293
+teridex_tui/screens/help.py,sha256=YCaXNW1f-MW_HFWbfMImoIejqQGWI_cRtL8gTAO6Nv0,2191
+teridex_tui/screens/history.py,sha256=YVKpY0ReTWjFNVWkqbBmhN2tbp3MD2_VvdvPfON2jIU,2809
+teridex_tui/screens/main.py,sha256=I68-6Luca2L_oJNyCiIyTBMDtomaImzqHPtWmpDCIx0,1947
+teridex_tui/themes/__init__.py,sha256=m1goovlUTDGLmIqp7ZiyAevzwQq3JcUsJ8FXW1uyHHw,196
+teridex_tui/themes/_base.py,sha256=U_0q59tclzsZK3RLZKixXfWOEHKwx_egGuW5lWw2PGE,712
+teridex_tui/themes/monokai.py,sha256=rjX8uE7u9BoxvP0lX_dpPqBhi8S_1ExW3zFFiHda5SQ,270
+teridex_tui/themes/nord.py,sha256=SmnJ9kKtTYF9Wcnk035B2QeU3cCOCEd9PlW09oueXao,264
+teridex_tui/widgets/__init__.py,sha256=ClBmkngBKp1tBK3YgRwLbfKmocLgyhufECJOphu1c6Q,440
+teridex_tui/widgets/action_bar.py,sha256=urwsHHjBYkYEg4Zi2y2-PxvDqC_y1WirDhgDYTVnXhM,1570
+teridex_tui/widgets/query_tabs.py,sha256=uq_FrMC9lGI_MylI52aQXxlpCAK_IQG89-KsfzdNFEQ,1262
+teridex_tui/widgets/results_table.py,sha256=LsChKQKgecQMm81g-xSK-5lPhy_CFusd3CKbFzKmKZQ,4008
+teridex_tui/widgets/schema_tree.py,sha256=fW2KaVsrcx1s-JdTFoYLzICqox4qOyqFi5o4md-80-Y,5161
+teridex_tui/widgets/sql_editor.py,sha256=RGLVXJml07uvto6MNiZfRwzrwvbI3JHjcE9BZsvaHIY,451
+teridex_tui/widgets/status_bar.py,sha256=bWvmmlhBfRx0YdyeV-_ND8hRrzehZ59vzo-QRjMvshk,2357
+teridex_tui/teridex.tcss,sha256=LffglMysUMLuQEO78I1_dr0yCCQj3YpO5wptjKoC6Mo,4411
+teridex-0.1.0.data/data/share/teridex/teridex.tcss,sha256=LffglMysUMLuQEO78I1_dr0yCCQj3YpO5wptjKoC6Mo,4411
+teridex-0.1.0.dist-info/METADATA,sha256=JtrtnAh6kSLVFbaHHHR9wbMHemlMZXsPBlNPC4PXt2Q,8816
+teridex-0.1.0.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
+teridex-0.1.0.dist-info/entry_points.txt,sha256=r8vzfTwyXOIJMYo58EZNcs--969-U7Cwl5a8GZ1wEEA,50
+teridex-0.1.0.dist-info/licenses/LICENSE,sha256=mc2jDLJgiCUp5k06wO8mwETj7G0bnsyyLe756FL-MoI,1119
+teridex-0.1.0.dist-info/RECORD,,

teridex-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.30.1
+Root-Is-Purelib: true
+Tag: py3-none-any

teridex-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+teridex = teridex_cli.main:main

teridex-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 **salvatorecorvaglia** (https://github.com/salvatorecorvaglia)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

teridex_adapters/__init__.py

@@ -0,0 +1,17 @@
+"""Teridex database adapters."""
+
+from teridex_adapters.base import AbstractAdapter
+from teridex_adapters.registry import (
+    AdapterRegistry,
+    create_adapter_for_dsn,
+    default_registry,
+    reset_default_registry,
+)
+
+__all__ = [
+    "AbstractAdapter",
+    "AdapterRegistry",
+    "create_adapter_for_dsn",
+    "default_registry",
+    "reset_default_registry",
+]

teridex_adapters/_introspect.py

@@ -0,0 +1,97 @@
+"""Shared introspection orchestration.
+
+Each adapter owns its own catalog queries (they are inherently DB-specific),
+but the per-object loop, kind dispatch, and ``SchemaSnapshot`` assembly live
+here once. Subclasses normalize ``kind`` to one of ``"table"``, ``"view"``,
+``"materialized_view"`` so the base class can dispatch without per-DB casing.
+"""
+
+from __future__ import annotations
+
+from abc import ABC, abstractmethod
+from typing import TYPE_CHECKING
+
+from teridex_core.models.schema import (
+    SchemaSnapshot,
+    Table,
+    View,
+)
+
+if TYPE_CHECKING:
+    from teridex_core.models.schema import (
+        ForeignKey,
+        Index,
+        SchemaObject,
+        TableColumn,
+    )
+
+
+class SchemaIntrospector(ABC):
+    """Template-method base that drives the per-object introspection loop."""
+
+    @abstractmethod
+    def connection_id(self) -> str: ...
+
+    @abstractmethod
+    def database_name(self) -> str | None: ...
+
+    @abstractmethod
+    async def list_objects(self) -> list[tuple[str, str, str]]:
+        """Return ``(schema, name, kind)`` for every visible table/view.
+
+        ``kind`` must be normalized to ``"table"``, ``"view"``, or
+        ``"materialized_view"``.
+        """
+
+    @abstractmethod
+    async def fetch_columns(self, schema: str, name: str) -> list[TableColumn]: ...
+
+    async def fetch_foreign_keys(self, schema: str, name: str) -> list[ForeignKey]:
+        return []
+
+    async def fetch_indexes(self, schema: str, name: str) -> list[Index]:
+        return []
+
+    def build_view(self, schema: str, name: str, kind: str, columns: list[TableColumn]) -> View:
+        from typing import Literal, cast  # noqa: PLC0415
+
+        return View(
+            name=name,
+            schema_name=schema,
+            columns=columns,
+            kind=cast('Literal["view", "materialized_view"]', kind),
+        )
+
+    async def build(self, *, lazy: bool = False) -> SchemaSnapshot:
+        schemas: dict[str, list[SchemaObject]] = {}
+        for schema_name, name, kind in await self.list_objects():
+            obj: SchemaObject
+            if lazy:
+                cols = []
+                fks = []
+                indexes = []
+            else:
+                cols = await self.fetch_columns(schema_name, name)
+                if kind == "table":
+                    fks = await self.fetch_foreign_keys(schema_name, name)
+                    indexes = await self.fetch_indexes(schema_name, name)
+                else:
+                    fks = []
+                    indexes = []
+
+            if kind == "table":
+                obj = Table(
+                    name=name,
+                    schema_name=schema_name,
+                    columns=cols,
+                    foreign_keys=fks,
+                    indexes=indexes,
+                )
+            else:
+                obj = self.build_view(schema_name, name, kind, cols)
+            schemas.setdefault(schema_name, []).append(obj)
+        return SchemaSnapshot(
+            connection_id=self.connection_id(),
+            database=self.database_name(),
+            schemas=schemas,
+        )