sqlide 0.1.0__py3-none-any.whl

sqlide-0.1.0.dist-info/METADATA

@@ -0,0 +1,151 @@
+Metadata-Version: 2.5
+Name: sqlide
+Version: 0.1.0
+Summary: Terminal SQL IDE (DataGrip-like) over JDBC
+Project-URL: Homepage, https://github.com/XFaIT/sqlide
+Project-URL: Repository, https://github.com/XFaIT/sqlide
+Project-URL: Issues, https://github.com/XFaIT/sqlide/issues
+Author: XFaIT
+License: MIT
+License-File: LICENSE
+Keywords: database,datagrip,jdbc,sql,terminal,tui
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Database :: Front-Ends
+Requires-Python: >=3.12
+Requires-Dist: httpx>=0.27
+Requires-Dist: jpype1>=1.5
+Requires-Dist: openpyxl>=3.1
+Requires-Dist: platformdirs>=4
+Requires-Dist: sqlglot>=25
+Requires-Dist: textual[syntax]>=0.80
+Requires-Dist: tomli-w>=1.0
+Description-Content-Type: text/markdown
+
+# sqlide
+
+A DataGrip-style SQL IDE that runs in your terminal. Connect to any database over JDBC,
+write SQL in an editor that outlines the statement about to run, and browse results in
+sortable, copyable tables that export to CSV, XLSX and more.
+
+Works on Linux, macOS and WSL.
+
+## Features
+
+- **Any JDBC database.** PostgreSQL and ClickHouse work out of the box; MySQL, MariaDB,
+  Oracle, SQL Server, H2, SQLite and DuckDB are one keypress away. Add your own driver from
+  jar files or Maven coordinates, as in DataGrip. Drivers are downloaded from Maven Central
+  (checksum verified) and each one gets its own class loader.
+- **Framed statement.** The statement under the cursor is outlined in the gutter; `F5`
+  runs it, a selection runs the selection, `Shift+F5` runs the whole file. Dialect-aware
+  splitting: `$$` quotes, nested comments, Oracle `/`, SQL Server `GO`, procedural blocks.
+- **Result grid.** Sort by several columns, filter, select a rectangle, view long values,
+  load more rows on demand. Copy as TSV, CSV, Markdown, JSON or `INSERT` statements.
+- **Export.** CSV, TSV, JSON, JSON Lines, Markdown, SQL inserts, HTML, XLSX. Export the loaded
+  rows or re-run the query and stream the full result to disk, with progress and cancel.
+- **Schema tree and autocomplete.** Lazy metadata, `SELECT *` on Enter, alias-aware column
+  completion, keywords and functions per dialect.
+- **Consoles and files.** Tabs with their own connection; consoles autosave and come back
+  after a restart; open and save `.sql` files (`sqlide a.sql b.sql`).
+- **History, formatting, transactions.** Searchable query history, SQL formatting,
+  Auto/Manual commit with Commit/Rollback.
+- **Rebindable keys, themes, command palette** (`Ctrl+P`). No AI features.
+
+## Install
+
+Requirements: Python 3.12+ and a Java 11+ runtime (`brew install openjdk`,
+`apt install openjdk-21-jre`, ...). Check with `sqlide doctor`.
+
+```sh
+uv tool install sqlide        # or: pipx install sqlide
+sqlide
+```
+
+Homebrew formula: see [packaging/homebrew](packaging/homebrew/README.md).
+
+## Quick start
+
+```sh
+sqlide driver install postgres   # or just connect: sqlide offers to download it
+sqlide                           # Ctrl+N: new connection, Enter on it: connect
+```
+
+Passwords are never written to disk. sqlide asks when you connect and keeps the password
+in memory until you quit. A connection can instead read it from an environment variable
+(`password_ref = "${env:PGPASSWORD}"`) or from a command such as a keychain CLI
+(`password_cmd = "security find-generic-password -s mydb -w"`).
+
+## Keys
+
+`sqlide keys` prints every rebindable action with its default key. Override in
+`~/.config/sqlide/keymap.toml`:
+
+```toml
+[keys]
+"editor.run" = "f4"
+```
+
+| Action | Keys |
+|---|---|
+| Run statement / selection | `F5`, `Ctrl+J`, `Ctrl+Enter`\* |
+| Run all | `Shift+F5` |
+| Cancel query | `Ctrl+F2` |
+| Autocomplete | `Ctrl+Space` (opens by itself after a dot) |
+| Format / comment | `F7` or `Ctrl+Alt+L` / `Ctrl+/` or `Alt+/` |
+| New connection / console / close tab | `Ctrl+N` / `Ctrl+T` / `Alt+W` |
+| Open / save file | `Ctrl+O` / `Ctrl+S` |
+| History | `Alt+E` |
+| Switch tab | `Alt+←` `Alt+→` |
+| Focus connections / schema / editor / results | `Alt+C` / `Alt+D` / `Alt+Q` / `Alt+R` (or `F6` / `Shift+F6` to cycle) |
+| Tx: toggle / commit / rollback | `F8` / `F9` / `F10` |
+| Grid: sort / copy / copy as / filter / export | `s` / `Ctrl+C` / `y` / `/` / `e` |
+| Command palette | `Ctrl+P` |
+| Quit | `Ctrl+Q` |
+
+\* Most terminals send `Ctrl+Enter` as plain `Enter`; it only works where the terminal
+speaks the kitty keyboard protocol. `Alt+Enter` is not used on purpose: it toggles
+full screen in Windows Terminal.
+
+## Files
+
+| What | Where (Linux and WSL; macOS uses the platform equivalents) |
+|---|---|
+| Settings, connections, custom drivers, keymap | `~/.config/sqlide/` |
+| Downloaded drivers, history, consoles | `~/.local/share/sqlide/` |
+
+Override with `SQLIDE_CONFIG_DIR` and `SQLIDE_DATA_DIR`.
+
+## Notes
+
+- Schema reads (tree, autocomplete) use a second connection, so they work while a query runs.
+  For in-memory databases (H2 `mem:`, SQLite `:memory:`, DuckDB) a second connection would see
+  a different database, so the query connection is shared and reads wait for a running query.
+- Autocomplete reads cached metadata. DDL you run in the editor refreshes it; changes made by
+  other clients need `F5` in the schema tree. In manual-commit mode new objects appear after
+  Commit.
+- MySQL `DELIMITER x` lines are understood (they are not sent to the server). On SQL Server,
+  `CREATE PROCEDURE/FUNCTION/TRIGGER` without `BEGIN..END` runs up to the next `GO`, as T-SQL does.
+- `Alt+1`..`Alt+4` only work in terminals with the kitty keyboard protocol; most terminals
+  deliver them as Mac characters, so use the letter keys or `F6`.
+- Tested on Linux and WSL against PostgreSQL, MySQL, MariaDB, ClickHouse, SQL Server, Oracle and
+  H2. macOS is covered by CI. On Windows, run it inside WSL (native Windows is not supported).
+
+## Development
+
+```sh
+uv sync
+uv run pytest                 # unit, H2 integration, Textual pilot tests
+uv run pytest -m docker       # also PostgreSQL in Docker
+uv run ruff check && uv run pyright
+```
+
+The code is split into blocks that depend only downwards: `ui → db, sql, grid, export,
+history, config → jvm, drivers`. The core never imports the UI.
+
+## License
+
+MIT

sqlide-0.1.0.dist-info/RECORD

@@ -0,0 +1,85 @@
+sqlide/__init__.py,sha256=bS5uJmdnv-G6pgsALLDgflgSRagr7r1MDlnTQCFzqVw,65
+sqlide/__main__.py,sha256=Yv08EcPhINeTLXU-RtRGdXzivukzUiDkjGguvjbQnI4,58
+sqlide/app.py,sha256=oMhwvl6xv84iWYlUDSYZ9CmjSywzWDKT24lUlUNlT8U,1690
+sqlide/cli.py,sha256=TfmpA0Z42V4w1jHhqTAYuw4vrSzoZBPFc82TcHeu-vw,1834
+sqlide/clipboard.py,sha256=DTJ3HvowHAZOKW2woCHmNtvmGAaTqzg7X6hmvGDMrBo,2131
+sqlide/consoles.py,sha256=-hBFjLxWqja8AdsFQq6-ZBibRJz9MlExLoSQorUuP5k,3456
+sqlide/doctor.py,sha256=pfgHZOhqlGHDOqOuGFcWtxli1vsexfugjVSB2gMGbUo,1616
+sqlide/workspace.py,sha256=k8o_Ix8Kl1Bu1dY8WLQgzmYw_9QWaICfr9Uf2Vb2ApY,3711
+sqlide/config/__init__.py,sha256=bGgzsLS8j51YeQlmRfb4QgoRsYd7N6sbueoaQYyORGg,84
+sqlide/config/_toml.py,sha256=AS08g9XBKdZH8EJptrvkoJ_NZb8deDmyVWqffZMYpks,1188
+sqlide/config/connections.py,sha256=bcHO5hkyOIssGc-o--zv95gJcKWPVi7-YhzhytbhG2E,2561
+sqlide/config/keymap.py,sha256=xt_-nP3CcV-d0i46ykIk547BOIORTniFvegDGWU-GUs,737
+sqlide/config/paths.py,sha256=xFvF-CEWYHRSO0QYKSHmWpcCE1iHVFiStZmNccB4vg0,999
+sqlide/config/secrets.py,sha256=irt7sF6rNmGmI1a42WCSTiUzc7AyHkCDcXBPWxogDxQ,2667
+sqlide/config/settings.py,sha256=WMlN-7G7oFZscJmbB-ml6ozJ0Bjq9IPKhWJidw9sckA,1033
+sqlide/db/__init__.py,sha256=RGLCR6ugndC1Tqbs4SbvsT1ugUOj4SgjgkmMzoXckUM,74
+sqlide/db/completion.py,sha256=eM4LtdZJHBZFGJUAwd7U1e1e36b5wxGkKimuf-C_WDY,4502
+sqlide/db/factory.py,sha256=OrVb9g2BJRD_Btj_5ii88slENYw91JoR3V-BjkOseG0,1250
+sqlide/db/metadata.py,sha256=zSe-4AnGKOdDm55jHXMaeoYeVa9u-Y5yH-XTDioPu9U,6002
+sqlide/db/result.py,sha256=G0SYYFe5MWMuJSQTzygrLyFIOVo-QWkbSHE3_rxN-0Y,1316
+sqlide/db/session.py,sha256=BueP3mYP3ek2CsmeIfa4Xd40D-3gL-Kn0zPlldgnZP0,12336
+sqlide/db/types.py,sha256=cgMcmgqW3RWlnEG6kNVIR6yRGlYMvOQJZXCktQWTcys,2856
+sqlide/drivers/__init__.py,sha256=8n__zNkh_AAk9vBkEfCV8MmapqeqBSGYb3da-T9945w,77
+sqlide/drivers/catalog.toml,sha256=BuRfdY1tEG7ETRrRuT58PtLX0S5nMnvDu_vih5aemhI,2532
+sqlide/drivers/cli.py,sha256=I0lQjtmLVz-jR1gWdxYNVEePfP3fmsWLxjeGxHEeAtA,2714
+sqlide/drivers/custom.py,sha256=1IBRR2W25KPfVtfl1xDhNkDE6BRfeccGTEJfEKP6kF8,2366
+sqlide/drivers/loader.py,sha256=xpAIuGEaEk20569wp8R3ImBKEZsmU1vwrlqppwPVStk,2696
+sqlide/drivers/maven.py,sha256=Av0rnc9EcJGqARj76wbqJb3JvsK2gdWGJAKM2Sn_GGE,4233
+sqlide/drivers/registry.py,sha256=LCBJscRUa5oVxuzlZ-RdJOTkoJbhbD8c0GLnQ6dx6wY,4449
+sqlide/export/__init__.py,sha256=idSLdEEIxKhwRio0Y43U-RD4V-kZi0bKVVCHmXw0tj8,377
+sqlide/export/base.py,sha256=zH80UnRc6_38ePDFlD7WdriHwNa-br6JtQlpoIxbn4U,2529
+sqlide/export/csv_.py,sha256=acZ6Y05r469mrKdFNeA3UDxHGwVy3yWpqHWndHMbM80,1163
+sqlide/export/html.py,sha256=jJStDDCh1spPrawSiZ91RzGOHKy_x0CbFQ5DELdsJBU,1430
+sqlide/export/json_.py,sha256=vcla2vs_kM-rXZD4i4hProQOoq4io9Z8z8HvOCIkIA4,1477
+sqlide/export/markdown.py,sha256=0HOao-sUKs7UzLo7BCitnI7g6BwSUi5XSNkVXXwTRyQ,876
+sqlide/export/service.py,sha256=eMfDJsEnmNUvdy3fegIACTpM-H7HsXao0DtuiHTYKi4,1043
+sqlide/export/sql_insert.py,sha256=N-ztrv74lDFBdibFdcRCVNDVe5gZJPb-JasdpTabV7U,1196
+sqlide/export/xlsx.py,sha256=ig2uL4KmueJdOv0d7_Fr3UbfqR527iiPMSjXwR3GPkk,3844
+sqlide/grid/__init__.py,sha256=j_fmSaeGWr1TV3OC2wTZzmx3oxjKLCcz4pOCGN4XMM8,74
+sqlide/grid/copyfmt.py,sha256=Qc7NLzWRJ3XfxJZuzUI68I7np-PX_doF3zlaCZFhKLQ,2932
+sqlide/grid/formatting.py,sha256=DTIndZILfegPr58IqG9VQOq-pTqEQATiilDhMy3lU3Q,1243
+sqlide/grid/model.py,sha256=L_o6ygATjl44qtHLF8-E_biNMrTYOaON2q7pP9zka84,4037
+sqlide/history/__init__.py,sha256=PI6JdMxlXlpRsSpmiFjQUYY2lOxiNF3NHnev80XtFoc,165
+sqlide/history/store.py,sha256=KGL3somblrpMpdeYI0KlHLjqHEwqt4CkFHfqWZtQKhk,3425
+sqlide/jvm/__init__.py,sha256=-8n8yky2vYbXDAzBboZ8fNd3551LlfnggVnHU8fm91U,78
+sqlide/jvm/locate.py,sha256=wbZLfzTnR_v7mhQU0sOM9YOBw7liYuzppNYID6Q7tf0,3056
+sqlide/jvm/runtime.py,sha256=EsuTiM77zgTfgHXDXQJIO5Hk1SqhISmsyZTyIDtioZE,1339
+sqlide/sql/__init__.py,sha256=gGxPiBDTVv8Fidtl79KOIvhoo4VhREs0PK1o2Yiirj0,74
+sqlide/sql/context.py,sha256=J1Tqf2NCuMfEVUMoiQSsq4MLTspmwMYBZpI3CsyQjGc,6559
+sqlide/sql/dialects.py,sha256=2B8I_U2X_oTIitTg8VCW2WcKuH6ky8Hi5g8E4MaLIq8,3519
+sqlide/sql/format.py,sha256=nqH_Wtm3PfalGUe6hT79aagFPaztEAGx0KzLz-jbLls,1711
+sqlide/sql/keywords.py,sha256=5iZ23_Zj3XE4dVyUQFFibXTqaiwHLAfaSQq_dKHwQTw,2766
+sqlide/sql/lexer.py,sha256=I3N5JKKdZB683eNZ3n2zXbFfyRS4a1Dgqroa3e3hw-c,4439
+sqlide/sql/snippets.py,sha256=3z1RA-AqAaWmNNK8WESZ7cjY3sMVe_oDygUj7DVMnMU,1716
+sqlide/sql/splitter.py,sha256=68RBppvPmdJ7rGbw1FFZVkk_SfhR5XATkf6VMkFkxwA,11195
+sqlide/ui/__init__.py,sha256=ch30s3b2RD_biCvR9HNmnH-mGtFyZ_f99uh8NYu3bFs,83
+sqlide/ui/app.tcss,sha256=ApOPe6hOB749x95DlJkcireciCUc5HyAfrbSt8kCQrs,1985
+sqlide/ui/commands.py,sha256=EcwCL7svMqJz1aAvPU8ygkxzIrMp0YjkHGK0S1uzGSw,2501
+sqlide/ui/keymap.py,sha256=Fw8r9xPeSuGbbCHgHJ1uhx_IMDaVrMWEVd9c8mM5gv4,919
+sqlide/ui/screens/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+sqlide/ui/screens/connection_editor.py,sha256=FwTjyJESy42S3twH9AuFxVaAJmOqFQIaENzsr5WWqiU,4573
+sqlide/ui/screens/dialogs.py,sha256=3XZzKhRjoOFPt2KfkdBsQc_B3R8e5X7lftRQt_TaXV4,3834
+sqlide/ui/screens/driver_manager.py,sha256=byF9LF3KYnpZq4wlPbsxhi6EwxYzGIcds_NlCgr2jsg,7469
+sqlide/ui/screens/export_dialog.py,sha256=ENj71-zSr8XPo46WdHfsxlJo2BJdoGgAeNG6G4nOmjk,6018
+sqlide/ui/screens/grid_dialogs.py,sha256=nSAgvGO3Iu477zOc3n2GV_u1PdqlhCgXpkxuZ194M9w,2949
+sqlide/ui/screens/history.py,sha256=6Ajk71ueVdBAOdrpHcrDuiWE_2PNjScDk1GfCq6y4c4,4718
+sqlide/ui/screens/main.py,sha256=Jg3Dh_h-Y0vjW5DgKuQBZE1Ez5zuhIU-8AD6P97lYo0,15293
+sqlide/ui/screens/settings.py,sha256=w2HivKIn9PYk1pkPs2sG1MiiPSt_ulq4kpJyTM2g8Rw,2919
+sqlide/ui/widgets/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+sqlide/ui/widgets/completion_popup.py,sha256=rMK7sq90pt44QB9dKKm1XnS_FM3dPGyWBAFPiCaWVRs,2242
+sqlide/ui/widgets/connections_list.py,sha256=jWIce4MxJcroIQ8W7wKWoV69ks1RAZ6cljq_wO7gUI8,1730
+sqlide/ui/widgets/console_export.py,sha256=kFa_LAbdhMjRvXe63kQ98Qy_1k_5v5KGrhs4BnBeKQw,5058
+sqlide/ui/widgets/console_tab.py,sha256=FgJhKND13nthMaaJdSmqbUGzOKktvtso2aIAesCSbJw,13377
+sqlide/ui/widgets/console_tabs.py,sha256=7C9hrQYibYmk7r5O36cxpzqBeVRCgXXzmXqLf0oe7D0,4431
+sqlide/ui/widgets/result_grid.py,sha256=X9GNqzBzyUsgW92jZQbV9FAA2g267-Cem-IafIKYFYg,16660
+sqlide/ui/widgets/result_panel.py,sha256=ZFXk8QG3e6Br0lXXzvlfJsCVBHnp8FVwjBXImJ81x-c,2386
+sqlide/ui/widgets/result_view.py,sha256=qHMybkYV9gRrPf3_s7NfrazAJHZo1qmcfOBMTOLxYGs,1546
+sqlide/ui/widgets/schema_tree.py,sha256=hso2OlAM2Con9jGbRftSQsR5eTVTHsDPXoD5ok1Kdrg,5544
+sqlide/ui/widgets/sql_editor.py,sha256=3f_m-Rz5RWlfT5Y1dw6yXb5q376bFKwcQAeU3XO5Gkw,11624
+sqlide/ui/widgets/status_bar.py,sha256=8V0WO4Cmo4ApQwKmsPGEo2i7_WKZl0sj8uFR_mCPRCM,896
+sqlide-0.1.0.dist-info/METADATA,sha256=dKN4qHkh49FBz695C4Kzv-IWlCBJozypXS9WBhfbkWE,6347
+sqlide-0.1.0.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
+sqlide-0.1.0.dist-info/entry_points.txt,sha256=XLcG9sNOP-UdwzRDL2ImiskvaN4ci5DTCs1iuQkXekA,43
+sqlide-0.1.0.dist-info/licenses/LICENSE,sha256=47qKZVDt7YpKkDjkzhXBTAJDNPFJHDOceQ_NnVh-jCI,1062
+sqlide-0.1.0.dist-info/RECORD,,

sqlide-0.1.0.dist-info/WHEEL

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

sqlide-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+sqlide = sqlide.cli:main

sqlide-0.1.0.dist-info/licenses/LICENSE

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