csvsql 0.1.0__tar.gz

csvsql-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Markus Kim
+
+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.

csvsql-0.1.0/MANIFEST.in

@@ -0,0 +1,3 @@
+include LICENSE
+include README.md
+recursive-include csvsql/static *

csvsql-0.1.0/PKG-INFO

@@ -0,0 +1,75 @@
+Metadata-Version: 2.4
+Name: csvsql
+Version: 0.1.0
+Summary: A browser-based CSV database with SQL query support
+Author: Markus Kim
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/markuskimius/csvsql
+Project-URL: Repository, https://github.com/markuskimius/csvsql
+Keywords: csv,sql,database,browser
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Web Environment
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Database
+Classifier: Topic :: Utilities
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# CSVSQL
+
+A browser-based database that uses CSV files as storage. Open CSV files as tables, run SQL queries against them, and edit data inline — all in a multi-window interface with no server or build step required.
+
+## Features
+
+- **CSV as database tables** — Each CSV file is a table. Open multiple files and query across them.
+- **SQL queries** — Write and execute SQL from the built-in console (powered by [AlaSQL](https://github.com/AlaSQL/alasql)). Each query result opens in its own window.
+- **Inline editing** — Click any cell to edit. Tab/Enter to navigate, Escape to cancel.
+- **Sort and filter** — Click column headers to sort. Use the filter bar to search across all columns.
+- **Multi-window workspace** — Every table and query result lives in its own draggable, resizable subwindow. Arrange them with Tile, Grid, or Cascade layouts.
+- **Row management** — Add/delete rows, insert rows at any position (right-click row numbers), add new columns.
+- **Save** — Export any table or query result back to CSV.
+
+## Getting Started
+
+No dependencies to install. Just serve the files or open directly:
+
+```sh
+# Option 1: any static file server
+python3 -m http.server 8000
+# then open http://localhost:8000
+
+# Option 2: open directly
+open index.html
+```
+
+Use **File > Open CSV** to load a CSV file (a `sample.csv` is included), or **File > New Table** to create one from scratch.
+
+## SQL Console
+
+The console sits at the bottom of the window. Type a query and press **Ctrl+Enter** (or click Run) to execute.
+
+```sql
+-- Query a loaded table by its filename (minus extension)
+SELECT * FROM sample WHERE name LIKE 'A%'
+
+-- Aggregate queries
+SELECT department, AVG(salary) as avg_salary FROM employees GROUP BY department
+
+-- Join across tables
+SELECT a.name, b.value FROM table1 a JOIN table2 b ON a.id = b.id
+```
+
+Table names are derived from the CSV filename (e.g., `employees.csv` becomes `employees`).
+
+## Keyboard Shortcuts
+
+| Key | Action |
+|---|---|
+| Ctrl+Enter | Execute SQL query |
+| Tab / Shift+Tab | Navigate between cells in a row |
+| Enter | Move to next row (same column) |
+| Escape | Cancel cell edit |

csvsql-0.1.0/README.md

@@ -0,0 +1,54 @@
+# CSVSQL
+
+A browser-based database that uses CSV files as storage. Open CSV files as tables, run SQL queries against them, and edit data inline — all in a multi-window interface with no server or build step required.
+
+## Features
+
+- **CSV as database tables** — Each CSV file is a table. Open multiple files and query across them.
+- **SQL queries** — Write and execute SQL from the built-in console (powered by [AlaSQL](https://github.com/AlaSQL/alasql)). Each query result opens in its own window.
+- **Inline editing** — Click any cell to edit. Tab/Enter to navigate, Escape to cancel.
+- **Sort and filter** — Click column headers to sort. Use the filter bar to search across all columns.
+- **Multi-window workspace** — Every table and query result lives in its own draggable, resizable subwindow. Arrange them with Tile, Grid, or Cascade layouts.
+- **Row management** — Add/delete rows, insert rows at any position (right-click row numbers), add new columns.
+- **Save** — Export any table or query result back to CSV.
+
+## Getting Started
+
+No dependencies to install. Just serve the files or open directly:
+
+```sh
+# Option 1: any static file server
+python3 -m http.server 8000
+# then open http://localhost:8000
+
+# Option 2: open directly
+open index.html
+```
+
+Use **File > Open CSV** to load a CSV file (a `sample.csv` is included), or **File > New Table** to create one from scratch.
+
+## SQL Console
+
+The console sits at the bottom of the window. Type a query and press **Ctrl+Enter** (or click Run) to execute.
+
+```sql
+-- Query a loaded table by its filename (minus extension)
+SELECT * FROM sample WHERE name LIKE 'A%'
+
+-- Aggregate queries
+SELECT department, AVG(salary) as avg_salary FROM employees GROUP BY department
+
+-- Join across tables
+SELECT a.name, b.value FROM table1 a JOIN table2 b ON a.id = b.id
+```
+
+Table names are derived from the CSV filename (e.g., `employees.csv` becomes `employees`).
+
+## Keyboard Shortcuts
+
+| Key | Action |
+|---|---|
+| Ctrl+Enter | Execute SQL query |
+| Tab / Shift+Tab | Navigate between cells in a row |
+| Enter | Move to next row (same column) |
+| Escape | Cancel cell edit |

csvsql-0.1.0/csvsql/__init__.py

@@ -0,0 +1,3 @@
+"""CSVSQL - A browser-based CSV database with SQL query support."""
+
+__version__ = "0.1.0"

csvsql-0.1.0/csvsql/__main__.py

@@ -0,0 +1,5 @@
+"""Allow running as `python -m csvsql`."""
+
+from .cli import main
+
+main()

csvsql-0.1.0/csvsql/cli.py

@@ -0,0 +1,58 @@
+"""CLI entry point — serves the CSVSQL web app and opens a browser."""
+
+import argparse
+import os
+import signal
+import sys
+import threading
+import webbrowser
+from functools import partial
+from http.server import HTTPServer, SimpleHTTPRequestHandler
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        prog="csvsql",
+        description="Browser-based CSV database with SQL query support.",
+    )
+    parser.add_argument(
+        "-p", "--port", type=int, default=8000, help="port to serve on (default: 8000)"
+    )
+    parser.add_argument(
+        "--no-browser", action="store_true", help="don't open a browser automatically"
+    )
+    parser.add_argument(
+        "--host", default="127.0.0.1", help="host to bind to (default: 127.0.0.1)"
+    )
+    args = parser.parse_args()
+
+    static_dir = os.path.join(os.path.dirname(__file__), "static")
+    handler = partial(SimpleHTTPRequestHandler, directory=static_dir)
+
+    # Try the requested port, increment if unavailable
+    port = args.port
+    for attempt in range(10):
+        try:
+            server = HTTPServer((args.host, port), handler)
+            break
+        except OSError:
+            port += 1
+    else:
+        print(f"Error: Could not find an available port.", file=sys.stderr)
+        sys.exit(1)
+
+    url = f"http://{args.host}:{port}"
+    print(f"Serving CSVSQL at {url}")
+    print("Press Ctrl+C to stop.")
+
+    if not args.no_browser:
+        threading.Timer(0.5, webbrowser.open, args=(url,)).start()
+
+    signal.signal(signal.SIGINT, lambda *_: sys.exit(0))
+
+    try:
+        server.serve_forever()
+    except KeyboardInterrupt:
+        pass
+    finally:
+        server.server_close()