openduck-cli 0.1.0__py3-none-any.whl

openduck/gui/widgets/query_tab.py

@@ -0,0 +1,63 @@
+"""Query tab container combining editor, results table, action buttons, and status bar."""
+
+from textual.app import ComposeResult
+from textual.containers import Horizontal, Vertical
+from textual.widgets import Button, DataTable, Static
+
+from openduck.gui.widgets.results_table import ResultsTable
+from openduck.gui.widgets.sql_editor import SqlTextArea
+
+
+class QueryTab(Vertical):
+    """A tab containing a SQL text editor, results table, action toolbar, and metadata bar."""
+
+    def __init__(self, sql: str = "", connection_id: str = None):
+        super().__init__()
+        self.initial_sql = sql
+        self.full_data, self.column_names, self.col_states = [], [], {}
+        self.running_task = None
+        self.connection_id = connection_id
+
+    def compose(self) -> ComposeResult:
+        text_area = SqlTextArea(
+            self.initial_sql,
+            language="sql",
+            id="query-input",
+            theme="vscode_dark",
+            soft_wrap=False,  # Disabled to prevent crash with long lines
+            read_only=False,
+            tab_behavior="indent",
+            show_line_numbers=True,
+        )
+        # Force SQL highlighting
+        try:
+            text_area.language = "sql"
+        except Exception:
+            pass
+        yield text_area
+        with Horizontal():  # Container for table and export sidebar
+            yield ResultsTable(id="results-table")
+            with Vertical(id="export-sidebar"):
+                yield Button("▶ Run", id="btn-run-query", classes="export-btn", variant="primary", tooltip="Run query / selection (Ctrl+Enter)")
+                yield Button("💬 --", id="btn-comment", classes="export-btn", tooltip="Toggle comment (F3 / Cmd+/)")
+                yield Button("↓CSV", id="export-csv", classes="export-btn")
+                yield Button("↓XLSX", id="export-excel", classes="export-btn")
+                yield Button("Abort", id="cancel-query", classes="export-btn", tooltip="Cancel Query", variant="error")
+        with Horizontal(id="metadata-container"):
+            yield Static("Ready", id="metadata-bar")
+            yield Static("Memory: N/A", id="memory-bar")
+
+    def on_mount(self):
+        t = self.query_one(DataTable)
+        t.cursor_type, t.zebra_stripes = "row", True
+        # Use slight delay for focus to allow UI to settle
+        self.set_timer(0.1, self.safe_focus)
+
+    def safe_focus(self):
+        """Focus the editor safely."""
+        try:
+            editor = self.query_one("#query-input")
+            editor.move_cursor((0, 0))
+            editor.focus()
+        except Exception:
+            pass

openduck/gui/widgets/resize_handle.py

@@ -0,0 +1,36 @@
+"""Draggable sidebar resize handle widget."""
+
+from textual.events import MouseDown, MouseMove, MouseUp
+from textual.widgets import Static
+
+from openduck.gui.styles import RESIZE_CSS
+
+
+class ResizeHandle(Static):
+    """A draggable handle to resize the sidebar."""
+
+    DEFAULT_CSS = RESIZE_CSS
+
+    def __init__(self):
+        super().__init__("┃")
+        self._dragging = False
+
+    def on_mouse_down(self, event: MouseDown) -> None:
+        self._dragging = True
+        self.capture_mouse()
+        event.stop()
+
+    def on_mouse_move(self, event: MouseMove) -> None:
+        if self._dragging:
+            # screen_x gives us the absolute position of the mouse
+            screen_width = self.screen.size.width
+            new_width = max(10, min(event.screen_x, screen_width - 20))
+            sidebar = self.screen.query_one("#sidebar")
+            sidebar.styles.width = new_width
+            event.stop()
+
+    def on_mouse_up(self, event: MouseUp) -> None:
+        if self._dragging:
+            self._dragging = False
+            self.release_mouse()
+            event.stop()

openduck/gui/widgets/results_table.py

@@ -0,0 +1,54 @@
+"""Data table widget for query results with copy and keyboard bindings."""
+
+import logging
+from textual.binding import Binding
+from textual.widgets import DataTable
+
+from openduck.core.clipboard import copy_to_system_clipboard
+
+logger = logging.getLogger(__name__)
+
+
+class ResultsTable(DataTable):
+    """DataTable for displaying SQL query results with system clipboard row/table copying."""
+
+    BINDINGS = [
+        *DataTable.BINDINGS,
+        Binding("ctrl+c,super+c", "copy_row", "Copy Row", show=False),
+        Binding("ctrl+a,super+a", "copy_table", "Copy All", show=False),
+    ]
+
+    def action_copy_row(self) -> None:
+        """Copy highlighted row or cell to clipboard."""
+        try:
+            if self.cursor_type == "row" and self.cursor_row is not None:
+                row_data = self.get_row_at(self.cursor_row)
+                text = "\t".join(str(v) if v is not None else "" for v in row_data)
+                copy_to_system_clipboard(text)
+                self.app.copy_to_clipboard(text)
+                self.notify(f"Rij gekopieerd ({len(row_data)} kolommen)", timeout=1.5)
+            elif self.cursor_type == "cell" and self.cursor_coordinate is not None:
+                cell_data = self.get_cell_at(self.cursor_coordinate)
+                text = str(cell_data) if cell_data is not None else ""
+                copy_to_system_clipboard(text)
+                self.app.copy_to_clipboard(text)
+                self.notify("Cel gekopieerd naar klembord", timeout=1.5)
+        except Exception as e:
+            logger.error(f"Error copying table row: {e}")
+
+    def action_copy_table(self) -> None:
+        """Copy entire table with column headers as TSV."""
+        try:
+            lines = []
+            headers = [col.label.plain for col in self.columns.values()]
+            if headers:
+                lines.append("\t".join(headers))
+            for row_idx in range(self.row_count):
+                row_data = self.get_row_at(row_idx)
+                lines.append("\t".join(str(v) if v is not None else "" for v in row_data))
+            text = "\n".join(lines)
+            copy_to_system_clipboard(text)
+            self.app.copy_to_clipboard(text)
+            self.notify(f"Tabel gekopieerd ({self.row_count} rijen)", timeout=1.5)
+        except Exception as e:
+            logger.error(f"Error copying entire table: {e}")

openduck/gui/widgets/sql_editor.py

@@ -0,0 +1,207 @@
+"""SQL editor widget with syntax highlighting, undo/redo, and keyboard bindings."""
+
+import re
+from textual.binding import Binding
+from textual.events import Click
+from textual.widgets import TextArea
+from textual.widgets.text_area import Selection
+
+from openduck.core.clipboard import copy_to_system_clipboard, get_system_clipboard
+from openduck.core.sql_utils import toggle_sql_comment_lines
+
+# Construct bindings for SqlTextArea
+_sql_text_area_bindings = []
+for b in TextArea.BINDINGS:
+    if b.action == "cursor_line_start":
+        _sql_text_area_bindings.append(Binding("home", "cursor_line_start", "Cursor line start", show=False))
+    elif b.action == "select_all":
+        _sql_text_area_bindings.append(Binding("f7,ctrl+a,super+a,cmd+a,command+a", "select_all", "Select all", show=False))
+    elif b.action == "copy":
+        _sql_text_area_bindings.append(Binding("ctrl+c,super+c,cmd+c,command+c", "copy", "Copy", show=False))
+    elif b.action == "paste":
+        _sql_text_area_bindings.append(Binding("ctrl+v,super+v,cmd+v,command+v", "paste", "Paste", show=False))
+    elif b.action == "cut":
+        _sql_text_area_bindings.append(Binding("ctrl+x,super+x,cmd+x,command+x", "cut", "Cut", show=False))
+    elif b.action == "undo":
+        _sql_text_area_bindings.append(Binding("ctrl+z,super+z,cmd+z,command+z", "undo", "Undo", show=False))
+    elif b.action == "redo":
+        _sql_text_area_bindings.append(Binding(
+            "ctrl+y,super+y,cmd+y,command+y,shift+ctrl+z,ctrl+shift+z,shift+super+z,super+shift+z,shift+cmd+z,cmd+shift+z,shift+command+z,command+shift+z",
+            "redo", "Redo", show=False
+        ))
+    else:
+        _sql_text_area_bindings.append(b)
+
+_sql_text_area_bindings.append(
+    Binding(
+        "f3,ctrl+slash,super+slash,cmd+slash,command+slash,ctrl+underscore,super+underscore,cmd+underscore,command+underscore,ctrl+7,super+7,ctrl+minus,super+minus",
+        "toggle_comment", "Comment", show=False
+    )
+)
+
+
+class SqlTextArea(TextArea):
+    """Specialized TextArea widget for SQL input with enhanced selection & clipboard support."""
+
+    allow_select = False
+    BINDINGS = _sql_text_area_bindings
+
+    def select_word_at(self, location: tuple[int, int]) -> None:
+        """Select the word at the given (row, col) location."""
+        row, col = location
+        if row >= self.document.line_count:
+            return
+        line = self.document.get_line(row)
+        if not line:
+            return
+        col = max(0, min(col, len(line)))
+
+        word_char_regex = re.compile(r'\w')
+        if col < len(line) and not word_char_regex.match(line[col]) and col > 0 and word_char_regex.match(line[col - 1]):
+            col -= 1
+
+        if col < len(line) and word_char_regex.match(line[col]):
+            start_col = col
+            while start_col > 0 and word_char_regex.match(line[start_col - 1]):
+                start_col -= 1
+            end_col = col
+            while end_col < len(line) and word_char_regex.match(line[end_col]):
+                end_col += 1
+            self.selection = Selection((row, start_col), (row, end_col))
+        else:
+            start_col = col
+            while start_col > 0 and not line[start_col - 1].isspace() and not word_char_regex.match(line[start_col - 1]):
+                start_col -= 1
+            end_col = col
+            while end_col < len(line) and not line[end_col].isspace() and not word_char_regex.match(line[end_col]):
+                end_col += 1
+            if start_col < end_col:
+                self.selection = Selection((row, start_col), (row, end_col))
+
+    async def _on_click(self, event: Click) -> None:
+        if event.chain == 2:
+            target = self.get_target_document_location(event)
+            self.select_word_at(target)
+            if self.selected_text:
+                copy_to_system_clipboard(self.selected_text)
+                self.app._clipboard = self.selected_text
+            event.stop()
+            return
+        elif event.chain == 3:
+            cursor_row, _ = self.get_target_document_location(event)
+            self.select_line(cursor_row)
+            if self.selected_text:
+                copy_to_system_clipboard(self.selected_text)
+                self.app._clipboard = self.selected_text
+            event.stop()
+            return
+        await super()._on_click(event)
+
+    def _end_mouse_selection(self) -> None:
+        """When mouse selection finishes, copy selected text automatically to system clipboard."""
+        super()._end_mouse_selection()
+        if self.selected_text:
+            copy_to_system_clipboard(self.selected_text)
+            self.app._clipboard = self.selected_text
+
+    def action_copy(self) -> None:
+        """Copy selected text (or current line if no selection, like VS Code) to system clipboard."""
+        selected_text = self.selected_text
+        if selected_text:
+            copy_to_system_clipboard(selected_text)
+            self.app.copy_to_clipboard(selected_text)
+            self.notify("Gekopieerd naar klembord", timeout=1.5)
+        else:
+            row = self.cursor_location[0]
+            line = self.document.get_line(row)
+            if line:
+                copy_to_system_clipboard(line)
+                self.app.copy_to_clipboard(line)
+                self.notify("Regel gekopieerd naar klembord", timeout=1.5)
+
+    def action_cut(self) -> None:
+        """Cut selected text to system clipboard."""
+        selected_text = self.selected_text
+        if selected_text:
+            copy_to_system_clipboard(selected_text)
+            self.app.copy_to_clipboard(selected_text)
+            self.replace("", *self.selection)
+            self.notify("Geknipt naar klembord", timeout=1.5)
+        else:
+            row = self.cursor_location[0]
+            line = self.document.get_line(row)
+            if line:
+                copy_to_system_clipboard(line)
+                self.app.copy_to_clipboard(line)
+                self.action_delete_line()
+                self.notify("Regel geknipt naar klembord", timeout=1.5)
+
+    def action_paste(self) -> None:
+        """Paste from system clipboard (macOS pbpaste / local clipboard)."""
+        if self.read_only:
+            return
+        text = get_system_clipboard()
+        if not text:
+            text = self.app.clipboard
+        if text:
+            if result := self._replace_via_keyboard(text, *self.selection):
+                self.move_cursor(result.end_location)
+
+    def action_select_all(self) -> None:
+        """Select all text in document."""
+        self.select_all()
+
+    def action_toggle_comment(self) -> None:
+        """Toggle SQL comment (-- ) like in VS Code."""
+        selection = self.selection
+        start_row, start_col = selection.start
+        end_row, end_col = selection.end
+
+        if start_row > end_row or (start_row == end_row and start_col > end_col):
+            start_row, end_row = end_row, start_row
+            start_col, end_col = end_col, start_col
+
+        if end_row > start_row and end_col == 0:
+            actual_end_row = end_row - 1
+        else:
+            actual_end_row = end_row
+
+        actual_end_row = min(actual_end_row, max(0, self.document.line_count - 1))
+        lines = [self.document.get_line(r) for r in range(start_row, actual_end_row + 1)]
+        new_lines = toggle_sql_comment_lines(lines)
+
+        replacement = "\n".join(new_lines)
+        self.replace(replacement, (start_row, 0), (actual_end_row, len(lines[-1])), maintain_selection_offset=False)
+
+        if selection.is_empty:
+            new_col = min(len(new_lines[0]), max(0, start_col + (len(new_lines[0]) - len(lines[0]))))
+            self.move_cursor((start_row, new_col))
+        else:
+            self.selection = Selection((start_row, 0), (actual_end_row, len(new_lines[-1])))
+
+        is_commented = any(l.lstrip().startswith("--") for l in new_lines if l.strip())
+        status = "toegevoegd (--)" if is_commented else "verwijderd"
+        self.notify(f"Commentaar {status}", timeout=1.2)
+
+    def on_key(self, event) -> None:
+        key = (event.key or "").lower()
+        if key in ("super+z", "cmd+z", "command+z", "ctrl+z"):
+            self.action_undo()
+            event.stop()
+            event.prevent_default()
+        elif key in (
+            "super+shift+z", "shift+super+z", "cmd+shift+z", "shift+cmd+z",
+            "command+shift+z", "shift+command+z", "ctrl+shift+z", "shift+ctrl+z",
+            "super+y", "cmd+y", "command+y", "ctrl+y"
+        ):
+            self.action_redo()
+            event.stop()
+            event.prevent_default()
+
+    def action_undo(self) -> None:
+        """Undo last action in editor."""
+        self.undo()
+
+    def action_redo(self) -> None:
+        """Redo last undone action in editor."""
+        self.redo()

openduck/main.py

@@ -0,0 +1,25 @@
+"""OpenDuck - Main application entry point."""
+
+import logging
+from openduck.gui.app import DuckCLI
+
+
+def setup_logging():
+    """Configure application logging."""
+    logging.basicConfig(
+        filename='openduck_debug.log',
+        level=logging.DEBUG,
+        format='%(asctime)s - %(name)s - %(levelname)s - %(funcName)s:%(lineno)d - %(message)s',
+        filemode='a'
+    )
+
+
+def main():
+    """Run OpenDuck."""
+    setup_logging()
+    app = DuckCLI()
+    app.run()
+
+
+if __name__ == "__main__":
+    main()

openduck_cli-0.1.0.dist-info/METADATA

@@ -0,0 +1,204 @@
+Metadata-Version: 2.4
+Name: openduck-cli
+Version: 0.1.0
+Summary: The Modern, Lightning-Fast Terminal SQL IDE & Data Explorer for DuckDB
+Author: Bertatron
+License-Expression: MIT
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: textual[syntax]>=0.50.0
+Requires-Dist: duckdb>=0.9.0
+Requires-Dist: pandas>=2.0.0
+Requires-Dist: openpyxl>=3.1.0
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pyinstaller; extra == "dev"
+Provides-Extra: db
+Requires-Dist: pymssql; extra == "db"
+
+# 🦆 OpenDuck
+
+<p align="center">
+  <b>The Modern, Lightning-Fast Terminal SQL IDE & Data Explorer for DuckDB</b>
+</p>
+
+<p align="center">
+  <img src="https://img.shields.io/badge/Python-3.10%2B-blue?style=for-the-badge&logo=python&logoColor=white" alt="Python 3.10+" />
+  <img src="https://img.shields.io/badge/DuckDB-Fast%20Analytics-yellow?style=for-the-badge&logo=duckdb&logoColor=black" alt="DuckDB" />
+  <img src="https://img.shields.io/badge/TUI-Textual-green?style=for-the-badge" alt="Textual" />
+  <img src="https://img.shields.io/badge/License-MIT-orange?style=for-the-badge" alt="MIT License" />
+</p>
+
+---
+
+<p align="center">
+  <img width="100%" alt="OpenDuck Interface" src="https://github.com/user-attachments/assets/4aea9df6-6f00-494d-a171-d76a9a3b8133" />
+</p>
+
+**OpenDuck** brings the power and speed of **DuckDB** straight to your terminal in an intuitive, multi-tab Text User Interface (TUI). Effortlessly browse files, inspect datasets, write queries with full syntax highlighting, sort and filter millions of rows in milliseconds, and export results — all without leaving your shell.
+
+---
+
+## ✨ Features
+
+- ⚡ **Instant File Queries**: Click or select any file (`.csv`, `.parquet`, `.xlsx`, `.json`, `.duckdb`, `.sqlite`, `.arrow`) from the sidebar to instantly load and execute queries with zero boilerplates.
+- 🎨 **Rich SQL Syntax Highlighting**: Tree-sitter powered VS Code Dark styling with real-time token highlighting for SQL keywords, strings, numbers, identifiers, and comments.
+- 🚀 **Asynchronous & Non-Blocking**: Queries execute in dedicated background threads — the interface remains buttery smooth and never freezes, even on heavy multi-gigabyte queries.
+- 📑 **Multi-Tab Workspace**: Work with multiple datasets simultaneously with tab navigation, close buttons (`✕`), and tab titles dynamically bound to files and queries.
+- 📊 **Interactive Data Viewer**:
+  - Sort columns ascending/descending with clickable headers (safe null handling).
+  - Quick column filters.
+  - Live query execution runtime, row count, and memory consumption stats.
+- 📋 **Terminal & System Clipboard Integration**:
+  - Copy highlighted cells or entire rows (`Ctrl+C`).
+  - Copy full query results as TSV (`Ctrl+A`).
+  - Native terminal copy & paste with multi-level Undo/Redo (`Cmd+Z` / `Ctrl+Z` / `Ctrl+Y`).
+  - Toggle SQL comments effortlessly (`F3` / `Cmd+/`).
+- 💾 **One-Click Export**: Export results to `.csv` or `.xlsx` files with a single click.
+- 📜 **History & Saved Queries**: Automatically preserves query history and lets you save reusable named queries with quick one-click recall into your editor.
+- 🎛️ **Draggable Resizable Sidebar**: Adjust the width of your sidebar on the fly with mouse drag.
+- 🛡️ **Intelligent Error Diagnostics**: Corrupted file, wrong delimiter, permission issue, or missing dataset? OpenDuck identifies the exact cause and displays human-readable actionable solutions.
+- 🐇 **Easter Egg**: Secret Matrix rain screensaver!
+
+---
+
+## 📂 Supported File Formats
+
+OpenDuck automatically recognises and formats queries for:
+
+| Format | Extensions | Query Mode |
+| :--- | :--- | :--- |
+| **Parquet** | `.parquet` | Native direct query |
+| **Arrow** | `.arrow` | Native direct query |
+| **CSV & GZ** | `.csv`, `.csv.gz` | `read_csv_auto(...)` |
+| **JSON & JSONL** | `.json`, `.jsonl` | `read_json_auto(...)` |
+| **Excel** | `.xlsx`, `.xls` | In-memory table registration (`pandas` + `openpyxl`) |
+| **SQLite** | `.sqlite`, `.sqlite3`, `.db` | Automatic SQLite extension attach |
+| **DuckDB** | `.duckdb` | Database attach & table explore |
+
+---
+
+## 🚀 Quickstart
+
+### 1. Installation
+
+**Via PyPI:**
+```bash
+pip install openduck-cli
+```
+
+**From source:**
+```bash
+git clone https://github.com/klandermans/openduck.git
+cd openduck
+pip install -r requirements.txt
+# or: pip install -e .
+```
+
+> **Note:** `textual[syntax]` installs the required `tree-sitter` and `tree-sitter-sql` engines for syntax highlighting out of the box.
+
+### 2. Run OpenDuck
+
+```bash
+python openduck.py
+```
+
+Or make it available system-wide as a command:
+
+```bash
+chmod +x openduck.sh
+sudo cp openduck.sh /usr/local/bin/openduck
+openduck
+```
+
+---
+
+## ⌨️ Keyboard & Mouse Shortcuts
+
+| Shortcut | Description |
+| :--- | :--- |
+| `Ctrl+Enter` / `Cmd+Enter` | **Run Query** (runs selection if text is selected, or full editor) |
+| `Ctrl+S` / `Cmd+S` | **Save Query** with custom name to `openduck.json` |
+| `F3` / `Cmd+/` / `Ctrl+/` | **Toggle SQL Comment** (`--`) on current line or selection |
+| `Ctrl+Z` / `Cmd+Z` | **Undo** last edit |
+| `Ctrl+Y` / `Cmd+Shift+Z` | **Redo** undone edit |
+| `Ctrl+W` / `Cmd+W` | **Close Current Tab** |
+| `Ctrl+M` | **Toggle Mouse Mode** (switch between TUI mouse and native terminal text selection) |
+| `Ctrl+C` / `Cmd+C` | **Copy** (Editor selection, or table row/cell to system clipboard) |
+| `Ctrl+A` / `Cmd+A` | **Copy Table** (when focused on results) / Select all (in editor) |
+| `F1` | **About Dialog** (click the duck for a surprise! 🕶️) |
+| `Ctrl+Q` / `Cmd+Q` | **Quit** OpenDuck |
+
+---
+
+## ⚙️ Configuration & Storage
+
+OpenDuck automatically manages `openduck.json` in your working directory. It persists:
+- The last 200 executed queries in chronological order.
+- Your named saved queries.
+- Database configurations.
+
+```json
+{
+  "history": [
+    {
+      "sql": "SELECT * FROM read_csv_auto('sales.csv') WHERE revenue > 1000 LIMIT 100;",
+      "timestamp": "2026-10-14T15:30:00.123456"
+    }
+  ],
+  "saved_queries": [
+    {
+      "name": "Q3 Revenue by Region",
+      "sql": "SELECT region, SUM(amount) FROM read_parquet('data/*.parquet') GROUP BY region;",
+      "timestamp": "2026-10-14T15:32:00.654321"
+    }
+  ],
+  "connections": []
+}
+```
+
+---
+
+## 💡 Tips & Tricks
+
+- **Click to Query**: Clicking any file in the left sidebar automatically populates the query into your active tab, updates the tab name, and executes the preview.
+- **Run Selection Only**: Highlight any part of your SQL script and press `Ctrl+Enter` to run only the highlighted snippet — just like in DBeaver, DataGrip, or VS Code!
+- **Selective Comments**: Select multiple lines and press `F3` or `Cmd+/` to comment or uncomment SQL blocks simultaneously.
+- **Instant Clipboard Sharing**: Results copied via `Ctrl+C` or `Ctrl+A` are immediately synced to your macOS (`pbcopy`), Linux (`wl-copy`/`xclip`), or Windows clipboard.
+
+---
+
+## 📁 Project Structure
+
+```text
+openduck/
+├── openduck/                 # Core Python package
+│   ├── __init__.py           # Package entry and exports
+│   ├── __main__.py           # CLI invocation (python -m openduck)
+│   ├── main.py               # Application bootstrap & logging setup
+│   ├── core/                 # Core logic & backend
+│   │   ├── config.py         # Config persistence, query history, saved queries
+│   │   ├── clipboard.py      # Cross-platform system clipboard integration
+│   │   ├── sql_utils.py      # SQL formatting, file-to-query mapper, comments
+│   │   └── error_classifier.py # Diagnostic error classifier
+│   └── gui/                  # Textual user interface
+│       ├── app.py            # Main DuckCLI application
+│       ├── styles.py         # Textual CSS stylesheets
+│       ├── screens/          # Modal screens (About, Matrix screensaver)
+│       ├── dialogs/          # Modal dialogs (Save Query, Export, Add DB)
+│       └── widgets/          # Custom widgets (Editor, ResultsTable, Trees, etc.)
+├── docs/                     # Documentation & guides
+├── scripts/                  # Build scripts & packaging specs
+├── tests/                    # Automated test suite
+├── samples/                  # Sample datasets for testing & exploration
+├── openduck.py               # Root executable script
+├── openduck.sh               # Shell launcher script
+└── pyproject.toml            # Python package configuration
+```
+
+---
+
+## 📜 License
+
+Distributed under the **MIT License**. See `LICENSE` for details.
+

openduck_cli-0.1.0.dist-info/RECORD

@@ -0,0 +1,30 @@
+openduck/__init__.py,sha256=blZkVJJEm5MV8UvCh7dU0Uhlteew0j6RpQPsCZHKX9M,1022
+openduck/__main__.py,sha256=vbtNJq4whJ_j0wceIQeAz_VpPmNUYEEK6K-X9HWfjyo,133
+openduck/main.py,sha256=1on3Q6dNMHglPq7Dy4FmlBm8CAbCNIsx7PIOoSm5oXc,513
+openduck/core/__init__.py,sha256=uXQyQ1S-e1NtHD2MkyrKZJoGVzAQnCGvKmScFFU3CyQ,924
+openduck/core/clipboard.py,sha256=BMfgqngof3lqBAwzbqX7xSeRKi-p4xMaYusp48nvwjo,1996
+openduck/core/config.py,sha256=Rwv0hYkDgeNymDRWsT11A6Ck3NzrJOfuX-B2OI5NTzI,3401
+openduck/core/error_classifier.py,sha256=rPCUYt8DeBg8kW_U7Cf5_ulWFYm0E9Wf010MPzSKbxA,3123
+openduck/core/sql_utils.py,sha256=SVUI3HUXAMuqBX5j_5uEXf_Mfdx5h4AdP_GjVXZ04lQ,2377
+openduck/gui/__init__.py,sha256=bwTTe2INx35q9QOCxS4Twz9y-SsbtD_cDj_BJzOVvc8,146
+openduck/gui/app.py,sha256=HsH_jy0BjUSe6XnqymU8Yiayf3fyFF1xBoFs3LVS22c,33735
+openduck/gui/styles.py,sha256=Psog9l8jgpI9zhNcmYgiu2Eufo2M73eycEQ_jCzGvGs,2603
+openduck/gui/dialogs/__init__.py,sha256=5coq1SnwAzs5wSWVN9IJu7HFgIT_3L9dQM2r_JpTsaI,307
+openduck/gui/dialogs/add_connection_dialog.py,sha256=RuMlgIPJOJlJ3BY82pCl9-BLwZJT39Fj98YNbmJQqbY,4092
+openduck/gui/dialogs/export_dialog.py,sha256=pb_Cy-priGiGIvB9isYXtnMEZ-GnnTIoqmYS2lZsdvA,4436
+openduck/gui/dialogs/save_query_dialog.py,sha256=s0Qf8B5uaKoDx7jIRH__zj9R2_dzMwPyj0CkcMad7oI,1600
+openduck/gui/screens/__init__.py,sha256=vp5_5h5igLaNjyvzbGfh1qR9aj4QCaBBL7WyY4FtpWU,244
+openduck/gui/screens/about.py,sha256=myUEf0x12ORnm92SNdsKEw__67ZCnF9fYUGuunIc54o,3153
+openduck/gui/screens/matrix.py,sha256=kxckiA0ErxAUFGVo2WK4dK-Nv1DkhRz8jKV2V-j2pJY,3181
+openduck/gui/widgets/__init__.py,sha256=6v47jeMAjSuksc2QqOn6glV7LejuFl_uzMNaxqXMz3g,498
+openduck/gui/widgets/database_tree.py,sha256=iyrZVsslvXlk2NX7O9HSGBnLO255ku7tnKWkMcCyHKU,4289
+openduck/gui/widgets/file_tree.py,sha256=iCTeWoVVDk2WaBntZ544qz_hg4zr6FOibzOxtE06W4U,464
+openduck/gui/widgets/query_tab.py,sha256=xnyr3hUIa231a1aPN6BtXOpsi4FJgSeCIwK8RJ6aZfM,2613
+openduck/gui/widgets/resize_handle.py,sha256=g4nBIvS0sKf-lmnUEzFx6jwzCklsgxRX2fDHdIjMwtY,1089
+openduck/gui/widgets/results_table.py,sha256=vUx2qTbV0y2nLRlSQbPaMqg4xWeJcClMTFUfLfXLzgI,2358
+openduck/gui/widgets/sql_editor.py,sha256=16ADxQZfWJQo1byv51hruBCwv8P3njUrUvmdjJ5zNEg,8774
+openduck_cli-0.1.0.dist-info/METADATA,sha256=1wHkEYmUW1zWjXOLgOkN3xriie9JTGPRudAG-Oy41pM,8670
+openduck_cli-0.1.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+openduck_cli-0.1.0.dist-info/entry_points.txt,sha256=MHqMGWlgdS2pUc2ra2zovSadppo0RhYStZWkBMDWZ1I,82
+openduck_cli-0.1.0.dist-info/top_level.txt,sha256=RI2CatGYvLV8ZiXyOEKqXcTfR5WEB7WOKc2SFfdZO3E,9
+openduck_cli-0.1.0.dist-info/RECORD,,

openduck_cli-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

openduck_cli-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+openduck = openduck.main:main
+openduck-cli = openduck.main:main

openduck_cli-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+openduck