sqlit-tui 0.2.1__tar.gz → 0.3.1__tar.gz

{sqlit_tui-0.2.1 → sqlit_tui-0.3.1}/.github/workflows/ci.yml

@@ -55,7 +55,7 @@ jobs:
 
       - name: Run SQLite integration tests
         run: |
-          pytest tests/ -v -k sqlite --timeout=60
+          pytest tests/test_sqlite.py -v --timeout=60
 
   test-mssql:
     runs-on: ubuntu-latest
@@ -115,7 +115,7 @@ jobs:
           MSSQL_USER: sa
           MSSQL_PASSWORD: TestPassword123!
         run: |
-          pytest tests/ -v -k mssql --timeout=120
+          pytest tests/test_mssql.py -v --timeout=120
 
   test-postgresql:
     runs-on: ubuntu-latest
@@ -159,7 +159,7 @@ jobs:
           POSTGRES_PASSWORD: TestPassword123!
           POSTGRES_DATABASE: test_sqlit
         run: |
-          pytest tests/ -v -k "PostgreSQL" --timeout=120
+          pytest tests/test_postgresql.py -v --timeout=120
 
   test-mysql:
     runs-on: ubuntu-latest
@@ -204,54 +204,68 @@ jobs:
           MYSQL_PASSWORD: TestPassword123!
           MYSQL_DATABASE: test_sqlit
         run: |
-          pytest tests/ -v -k "MySQL" --timeout=120
+          pytest tests/test_mysql.py -v --timeout=120
 
-  test-all:
+  test-oracle:
     runs-on: ubuntu-latest
-    needs: [test-sqlite, test-mssql, test-postgresql, test-mysql]
+    needs: build
 
     services:
-      mssql:
-        image: mcr.microsoft.com/mssql/server:2022-latest
+      oracle:
+        image: gvenzl/oracle-free:23-slim
         env:
-          ACCEPT_EULA: Y
-          MSSQL_SA_PASSWORD: TestPassword123!
-          MSSQL_PID: Developer
+          ORACLE_PASSWORD: TestPassword123!
+          APP_USER: testuser
+          APP_USER_PASSWORD: TestPassword123!
         ports:
-          - 1433:1433
+          - 1521:1521
         options: >-
-          --health-cmd "/opt/mssql-tools18/bin/sqlcmd -S localhost -U sa -P 'TestPassword123!' -C -Q 'SELECT 1' || exit 1"
+          --health-cmd "healthcheck.sh"
           --health-interval 10s
           --health-timeout 5s
-          --health-retries 10
-          --health-start-period 30s
+          --health-retries 20
+          --health-start-period 60s
 
-      postgres:
-        image: postgres:16-alpine
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python 3.12
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[test]"
+          pip install oracledb
+
+      - name: Run Oracle integration tests
         env:
-          POSTGRES_USER: testuser
-          POSTGRES_PASSWORD: TestPassword123!
-          POSTGRES_DB: test_sqlit
-        ports:
-          - 5432:5432
-        options: >-
-          --health-cmd "pg_isready -U testuser -d test_sqlit"
-          --health-interval 5s
-          --health-timeout 5s
-          --health-retries 10
-          --health-start-period 10s
+          ORACLE_HOST: localhost
+          ORACLE_PORT: 1521
+          ORACLE_USER: testuser
+          ORACLE_PASSWORD: TestPassword123!
+          ORACLE_SERVICE: FREEPDB1
+        run: |
+          pytest tests/test_oracle.py -v --timeout=120
 
-      mysql:
-        image: mysql:8.0
+  test-mariadb:
+    runs-on: ubuntu-latest
+    needs: build
+
+    services:
+      mariadb:
+        image: mariadb:11
         env:
-          MYSQL_ROOT_PASSWORD: TestPassword123!
-          MYSQL_USER: testuser
-          MYSQL_PASSWORD: TestPassword123!
-          MYSQL_DATABASE: test_sqlit
+          MARIADB_ROOT_PASSWORD: TestPassword123!
+          MARIADB_USER: testuser
+          MARIADB_PASSWORD: TestPassword123!
+          MARIADB_DATABASE: test_sqlit
         ports:
-          - 3306:3306
+          - 3307:3306
         options: >-
-          --health-cmd "mysqladmin ping -h localhost -u testuser -pTestPassword123!"
+          --health-cmd "healthcheck.sh --connect --innodb_initialized"
           --health-interval 5s
           --health-timeout 5s
           --health-retries 10
@@ -265,45 +279,89 @@ jobs:
         with:
           python-version: "3.12"
 
-      - name: Install ODBC driver
+      - name: Install MariaDB Connector/C
         run: |
-          curl https://packages.microsoft.com/keys/microsoft.asc | sudo tee /etc/apt/trusted.gpg.d/microsoft.asc
-          curl https://packages.microsoft.com/config/ubuntu/22.04/prod.list | sudo tee /etc/apt/sources.list.d/mssql-release.list
           sudo apt-get update
-          sudo ACCEPT_EULA=Y apt-get install -y msodbcsql18 unixodbc-dev
+          sudo apt-get install -y libmariadb-dev
 
       - name: Install dependencies
         run: |
           python -m pip install --upgrade pip
           pip install -e ".[test]"
-          pip install psycopg2-binary mysql-connector-python
+          pip install mariadb
 
-      - name: Wait for SQL Server to be ready
+      - name: Run MariaDB integration tests
+        env:
+          MARIADB_HOST: 127.0.0.1
+          MARIADB_PORT: 3307
+          MARIADB_USER: root
+          MARIADB_PASSWORD: TestPassword123!
+          MARIADB_DATABASE: test_sqlit
         run: |
+          pytest tests/test_mariadb.py -v --timeout=120
+
+  test-duckdb:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.12"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[test]"
+          pip install duckdb
+
+      - name: Run DuckDB integration tests
+        run: |
+          pytest tests/test_duckdb.py -v --timeout=60
+
+  test-cockroachdb:
+    runs-on: ubuntu-latest
+    needs: build
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python 3.12
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[test]"
+          pip install psycopg2-binary
+
+      - name: Start CockroachDB
+        run: |
+          docker run -d --name cockroachdb \
+            -p 26257:26257 -p 8080:8080 \
+            cockroachdb/cockroach:latest start-single-node --insecure
           for i in {1..30}; do
-            if /opt/mssql-tools18/bin/sqlcmd -S localhost -U sa -P 'TestPassword123!' -C -Q "SELECT 1" &> /dev/null; then
-              echo "SQL Server is ready"
+            if curl -sf http://localhost:8080/health > /dev/null 2>&1; then
+              echo "CockroachDB is ready"
               break
             fi
-            echo "Waiting for SQL Server... ($i/30)"
+            echo "Waiting for CockroachDB... ($i/30)"
             sleep 2
           done
 
-      - name: Run all integration tests
+      - name: Run CockroachDB integration tests
         env:
-          MSSQL_HOST: localhost
-          MSSQL_PORT: 1433
-          MSSQL_USER: sa
-          MSSQL_PASSWORD: TestPassword123!
-          POSTGRES_HOST: localhost
-          POSTGRES_PORT: 5432
-          POSTGRES_USER: testuser
-          POSTGRES_PASSWORD: TestPassword123!
-          POSTGRES_DATABASE: test_sqlit
-          MYSQL_HOST: localhost
-          MYSQL_PORT: 3306
-          MYSQL_USER: root
-          MYSQL_PASSWORD: TestPassword123!
-          MYSQL_DATABASE: test_sqlit
+          COCKROACHDB_HOST: localhost
+          COCKROACHDB_PORT: 26257
+          COCKROACHDB_USER: root
+          COCKROACHDB_PASSWORD: ""
+          COCKROACHDB_DATABASE: test_sqlit
         run: |
-          pytest tests/ -v --timeout=120
+          pytest tests/test_cockroachdb.py -v --timeout=120

sqlit_tui-0.3.1/CONTRIBUTING.md

@@ -0,0 +1,130 @@
+# Contributing
+
+Thank you for considering a contribution to sqlit! This guide walks you through setting up your environment, running the test suite, and understanding the CI expectations.
+
+## Development Setup
+
+1. Clone the repository:
+   ```bash
+   git clone https://github.com/Maxteabag/sqlit.git
+   cd sqlit
+   ```
+
+2. Install in development mode with test dependencies:
+   ```bash
+   pip install -e ".[dev]"
+   ```
+
+## Running Tests
+
+### SQLite Tests (No Docker Required)
+
+SQLite tests can run without any external dependencies:
+
+```bash
+pytest tests/ -v -k sqlite
+```
+
+### Full Test Suite (Requires Docker)
+
+To run the complete test suite including SQL Server, PostgreSQL, MySQL, MariaDB, Oracle, DuckDB, and CockroachDB tests:
+
+1. Start the test database containers:
+   ```bash
+   docker compose -f docker-compose.test.yml up -d
+   ```
+
+2. Wait for the databases to be ready (about 30-45 seconds), then run tests:
+   ```bash
+   pytest tests/ -v
+   ```
+
+You can leave the containers running between test runs - the test fixtures handle database setup/teardown automatically. Stop them when you're done developing:
+
+```bash
+docker compose -f docker-compose.test.yml down
+```
+
+### Running Tests for Specific Databases
+
+```bash
+pytest tests/ -v -k sqlite      # SQLite only
+pytest tests/ -v -k mssql       # SQL Server only
+pytest tests/ -v -k PostgreSQL  # PostgreSQL only
+pytest tests/ -v -k MySQL       # MySQL only
+pytest tests/ -v -k cockroach   # CockroachDB only
+```
+
+### Environment Variables
+
+The database tests can be configured with these environment variables:
+
+**SQL Server:**
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `MSSQL_HOST` | `localhost` | SQL Server hostname |
+| `MSSQL_PORT` | `1434` | SQL Server port |
+| `MSSQL_USER` | `sa` | SQL Server username |
+| `MSSQL_PASSWORD` | `TestPassword123!` | SQL Server password |
+
+**PostgreSQL:**
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `POSTGRES_HOST` | `localhost` | PostgreSQL hostname |
+| `POSTGRES_PORT` | `5432` | PostgreSQL port |
+| `POSTGRES_USER` | `testuser` | PostgreSQL username |
+| `POSTGRES_PASSWORD` | `TestPassword123!` | PostgreSQL password |
+| `POSTGRES_DATABASE` | `test_sqlit` | PostgreSQL database |
+
+**MySQL:**
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `MYSQL_HOST` | `localhost` | MySQL hostname |
+| `MYSQL_PORT` | `3306` | MySQL port |
+| `MYSQL_USER` | `root` | MySQL username |
+| `MYSQL_PASSWORD` | `TestPassword123!` | MySQL password |
+| `MYSQL_DATABASE` | `test_sqlit` | MySQL database |
+
+**CockroachDB:**
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `COCKROACHDB_HOST` | `localhost` | CockroachDB hostname |
+| `COCKROACHDB_PORT` | `26257` | CockroachDB port |
+| `COCKROACHDB_USER` | `root` | CockroachDB username |
+| `COCKROACHDB_PASSWORD` | `` | CockroachDB password (empty for the included Docker container) |
+| `COCKROACHDB_DATABASE` | `test_sqlit` | CockroachDB database |
+
+### CockroachDB Quickstart (Docker)
+
+1. Start the included CockroachDB container:
+   ```bash
+   docker compose -f docker-compose.test.yml up -d cockroachdb
+   ```
+2. Create a connection (default container runs insecure mode on port `26257` with `root` user):
+   ```bash
+   sqlit connection create \
+     --name "LocalCockroach" \
+     --db-type cockroachdb \
+     --server "localhost" \
+     --port "26257" \
+     --database "defaultdb" \
+     --username "root"
+   ```
+3. Launch sqlit and connect:
+   ```bash
+   sqlit
+   ```
+
+## CI/CD
+
+The project uses GitHub Actions for continuous integration:
+
+- **Build**: Verifies the package builds on Python 3.10-3.13
+- **SQLite Tests**: Runs SQLite integration tests (no external dependencies)
+- **SQL Server Tests**: Runs SQL Server integration tests with Docker service
+- **PostgreSQL Tests**: Runs PostgreSQL integration tests with Docker service
+- **MySQL Tests**: Runs MySQL integration tests with Docker service
+- **MariaDB/Oracle/DuckDB/CockroachDB Tests**: Runs the remaining database integration tests with Docker service where applicable
+- **Full Test Suite**: Runs all tests across every supported database
+
+Pull requests must pass all CI checks before merging.

{sqlit_tui-0.2.1 → sqlit_tui-0.3.1}/PKG-INFO

@@ -1,14 +1,14 @@
 Metadata-Version: 2.4
 Name: sqlit-tui
-Version: 0.2.1
-Summary: A terminal UI for SQL Server, PostgreSQL, MySQL, and SQLite
+Version: 0.3.1
+Summary: A terminal UI for SQL Server, PostgreSQL, MySQL, SQLite, and Oracle
 Project-URL: Homepage, https://github.com/Maxteabag/sqlit
 Project-URL: Repository, https://github.com/Maxteabag/sqlit
 Project-URL: Issues, https://github.com/Maxteabag/sqlit/issues
 Author: Peter
 License-Expression: MIT
 License-File: LICENSE
-Keywords: database,mssql,mysql,postgresql,server,sql,sqlite,terminal,tui
+Keywords: database,mssql,mysql,oracle,postgresql,server,sql,sqlite,terminal,tui
 Classifier: Development Status :: 4 - Beta
 Classifier: Environment :: Console
 Classifier: Intended Audience :: Developers
@@ -22,6 +22,7 @@ Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Database
 Requires-Python: >=3.10
 Requires-Dist: pyodbc>=5.0.0
+Requires-Dist: pyperclip>=1.8.2
 Requires-Dist: textual[syntax]>=0.50.0
 Provides-Extra: dev
 Requires-Dist: build; extra == 'dev'
@@ -34,17 +35,21 @@ Description-Content-Type: text/markdown
 
 # sqlit
 
-A simple terminal UI for SQL Server, PostgreSQL, MySQL, and SQLite, for those who just want to run some queries.
+A simple terminal UI for SQL Server, PostgreSQL, MySQL, SQLite, and more—built for people who just want to run some queries fast.
 
 ![Python](https://img.shields.io/badge/python-3.10+-blue.svg)
 ![License](https://img.shields.io/badge/license-MIT-green.svg)
 
-![Demo](demo-query.gif)
+### Multi-database Support
+![Database Providers](demo-providers.gif)
+
+### Query History
+![Query History](demo-history.gif)
 
 
 ## Features
 
-- **Multi-database support**: SQL Server, PostgreSQL, MySQL, and SQLite
+- **Multi-database support**: SQL Server, PostgreSQL, MySQL, SQLite, MariaDB, Oracle, DuckDB, and CockroachDB
 - **Query history**: Automatically saves queries per connection, searchable and sortable
 - Fast and intuitive keyboard only control
 - Context based help (no need to memorize tons of hot-keys)
@@ -69,7 +74,7 @@ The problem got severely worse when I switched to Linux and had to rely on VS CO
 
 I tried to use some existing TUI's for SQL, but they were not intuitive for me and I missed the immediate ease of use that other TUI's such as Lazygit provides.
 
-sqlit is a lightweight database TUI that is easy to use and beautiful to look at, just connect and query. It's for you that just wants to run queries toward your database without launching applications that eats your ram and takes time to load up. Sqlit supports SQL Server, PostgreSQL, MySQL, and SQLite, and is designed to make it easy and enjoyable to access your data, not painful.
+sqlit is a lightweight database TUI that is easy to use and beautiful to look at, just connect and query. It's for you that just wants to run queries toward your database without launching applications that eats your ram and takes time to load up. Sqlit supports SQL Server, PostgreSQL, MySQL, SQLite, MariaDB, Oracle, DuckDB, and CockroachDB, and is designed to make it easy and enjoyable to access your data, not painful.
 
 
 ## Installation
@@ -80,10 +85,10 @@ pip install sqlit-tui
 
 For SQL Server, sqlit will detect if you're missing ODBC drivers and help you install them.
 
-For PostgreSQL and MySQL, install the optional drivers:
+For PostgreSQL, CockroachDB, and MySQL, install the optional drivers:
 
 ```bash
-# PostgreSQL
+# PostgreSQL / CockroachDB
 pip install psycopg2-binary
 
 # MySQL
@@ -114,6 +119,7 @@ sqlit query -c "MyConnection" -f "script.sql" --format json
 sqlit connection create --name "MySqlServer" --db-type mssql --server "localhost" --auth-type sql
 sqlit connection create --name "MyPostgres" --db-type postgresql --server "localhost" --username "user" --password "pass"
 sqlit connection create --name "MyMySQL" --db-type mysql --server "localhost" --username "user" --password "pass"
+sqlit connection create --name "MyCockroach" --db-type cockroachdb --server "localhost" --port "26257" --database "defaultdb" --username "root"
 sqlit connection create --name "MyLocalDB" --db-type sqlite --file-path "/path/to/database.db"
 
 # Manage connections
@@ -146,100 +152,7 @@ Connections and settings are stored in `~/.sqlit/`.
 
 ## Contributing
 
-### Development Setup
-
-1. Clone the repository:
-   ```bash
-   git clone https://github.com/Maxteabag/sqlit.git
-   cd sqlit
-   ```
-
-2. Install in development mode with test dependencies:
-   ```bash
-   pip install -e ".[dev]"
-   ```
-
-### Running Tests
-
-#### SQLite Tests (No Docker Required)
-
-SQLite tests can run without any external dependencies:
-
-```bash
-pytest tests/ -v -k sqlite
-```
-
-#### Full Test Suite (Requires Docker)
-
-To run the complete test suite including SQL Server, PostgreSQL, and MySQL tests:
-
-1. Start the test database containers:
-   ```bash
-   docker compose -f docker-compose.test.yml up -d
-   ```
-
-2. Wait for the databases to be ready (about 30-45 seconds), then run tests:
-   ```bash
-   pytest tests/ -v
-   ```
-
-You can leave the containers running between test runs - the test fixtures handle database setup/teardown automatically. Stop them when you're done developing:
-
-```bash
-docker compose -f docker-compose.test.yml down
-```
-
-#### Running Tests for Specific Databases
-
-```bash
-pytest tests/ -v -k sqlite      # SQLite only
-pytest tests/ -v -k mssql       # SQL Server only
-pytest tests/ -v -k PostgreSQL  # PostgreSQL only
-pytest tests/ -v -k MySQL       # MySQL only
-```
-
-#### Environment Variables
-
-The database tests can be configured with these environment variables:
-
-**SQL Server:**
-| Variable | Default | Description |
-|----------|---------|-------------|
-| `MSSQL_HOST` | `localhost` | SQL Server hostname |
-| `MSSQL_PORT` | `1434` | SQL Server port |
-| `MSSQL_USER` | `sa` | SQL Server username |
-| `MSSQL_PASSWORD` | `TestPassword123!` | SQL Server password |
-
-**PostgreSQL:**
-| Variable | Default | Description |
-|----------|---------|-------------|
-| `POSTGRES_HOST` | `localhost` | PostgreSQL hostname |
-| `POSTGRES_PORT` | `5432` | PostgreSQL port |
-| `POSTGRES_USER` | `testuser` | PostgreSQL username |
-| `POSTGRES_PASSWORD` | `TestPassword123!` | PostgreSQL password |
-| `POSTGRES_DATABASE` | `test_sqlit` | PostgreSQL database |
-
-**MySQL:**
-| Variable | Default | Description |
-|----------|---------|-------------|
-| `MYSQL_HOST` | `localhost` | MySQL hostname |
-| `MYSQL_PORT` | `3306` | MySQL port |
-| `MYSQL_USER` | `root` | MySQL username |
-| `MYSQL_PASSWORD` | `TestPassword123!` | MySQL password |
-| `MYSQL_DATABASE` | `test_sqlit` | MySQL database |
-
-### CI/CD
-
-The project uses GitHub Actions for continuous integration:
-
-- **Build**: Verifies the package builds on Python 3.10-3.13
-- **SQLite Tests**: Runs SQLite integration tests (no external dependencies)
-- **SQL Server Tests**: Runs SQL Server integration tests with Docker service
-- **PostgreSQL Tests**: Runs PostgreSQL integration tests with Docker service
-- **MySQL Tests**: Runs MySQL integration tests with Docker service
-- **Full Test Suite**: Runs all tests with all four databases
-
-Pull requests must pass all CI checks before merging.
+See `CONTRIBUTING.md` for development setup, testing, CI, and CockroachDB quickstart steps.
 
 ## License