sqlit-tui 0.4.2__tar.gz

sqlit_tui-0.4.2/.github/workflows/ci.yml

@@ -0,0 +1,450 @@
+name: CI
+
+on:
+  push:
+    branches: [main, master]
+  pull_request:
+    branches: [main, master]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
+
+    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 build
+          pip install -e .
+
+      - name: Check package builds
+        run: python -m build
+
+      - name: Verify CLI entry point
+        run: |
+          python -c "from sqlit.cli import main; print('CLI import OK')"
+
+  test-sqlite:
+    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]"
+
+      - name: Run SQLite integration tests
+        run: |
+          pytest tests/test_sqlite.py -v --timeout=60
+
+  test-mssql:
+    runs-on: ubuntu-latest
+    needs: build
+
+    services:
+      mssql:
+        image: mcr.microsoft.com/mssql/server:2022-latest
+        env:
+          ACCEPT_EULA: Y
+          MSSQL_SA_PASSWORD: TestPassword123!
+          MSSQL_PID: Developer
+        ports:
+          - 1433:1433
+        options: >-
+          --health-cmd "/opt/mssql-tools18/bin/sqlcmd -S localhost -U sa -P 'TestPassword123!' -C -Q 'SELECT 1' || exit 1"
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 10
+          --health-start-period 30s
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python 3.12
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install ODBC driver
+        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
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[test]"
+
+      - name: Wait for SQL Server to be ready
+        run: |
+          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"
+              break
+            fi
+            echo "Waiting for SQL Server... ($i/30)"
+            sleep 2
+          done
+
+      - name: Run SQL Server integration tests
+        env:
+          MSSQL_HOST: localhost
+          MSSQL_PORT: 1433
+          MSSQL_USER: sa
+          MSSQL_PASSWORD: TestPassword123!
+        run: |
+          pytest tests/test_mssql.py -v --timeout=120
+
+  test-postgresql:
+    runs-on: ubuntu-latest
+    needs: build
+
+    services:
+      postgres:
+        image: postgres:16-alpine
+        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
+
+    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: Run PostgreSQL integration tests
+        env:
+          POSTGRES_HOST: localhost
+          POSTGRES_PORT: 5432
+          POSTGRES_USER: testuser
+          POSTGRES_PASSWORD: TestPassword123!
+          POSTGRES_DATABASE: test_sqlit
+        run: |
+          pytest tests/test_postgresql.py -v --timeout=120
+
+  test-mysql:
+    runs-on: ubuntu-latest
+    needs: build
+
+    services:
+      mysql:
+        image: mysql:8.0
+        env:
+          MYSQL_ROOT_PASSWORD: TestPassword123!
+          MYSQL_USER: testuser
+          MYSQL_PASSWORD: TestPassword123!
+          MYSQL_DATABASE: test_sqlit
+        ports:
+          - 3306:3306
+        options: >-
+          --health-cmd "mysqladmin ping -h localhost -u testuser -pTestPassword123!"
+          --health-interval 5s
+          --health-timeout 5s
+          --health-retries 10
+          --health-start-period 30s
+
+    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 mysql-connector-python
+
+      - name: Run MySQL integration tests
+        env:
+          MYSQL_HOST: localhost
+          MYSQL_PORT: 3306
+          MYSQL_USER: root
+          MYSQL_PASSWORD: TestPassword123!
+          MYSQL_DATABASE: test_sqlit
+        run: |
+          pytest tests/test_mysql.py -v --timeout=120
+
+  test-oracle:
+    runs-on: ubuntu-latest
+    needs: build
+
+    services:
+      oracle:
+        image: gvenzl/oracle-free:23-slim
+        env:
+          ORACLE_PASSWORD: TestPassword123!
+          APP_USER: testuser
+          APP_USER_PASSWORD: TestPassword123!
+        ports:
+          - 1521:1521
+        options: >-
+          --health-cmd "healthcheck.sh"
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 20
+          --health-start-period 60s
+
+    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:
+          ORACLE_HOST: localhost
+          ORACLE_PORT: 1521
+          ORACLE_USER: testuser
+          ORACLE_PASSWORD: TestPassword123!
+          ORACLE_SERVICE: FREEPDB1
+        run: |
+          pytest tests/test_oracle.py -v --timeout=120
+
+  test-mariadb:
+    runs-on: ubuntu-latest
+    needs: build
+
+    services:
+      mariadb:
+        image: mariadb:11
+        env:
+          MARIADB_ROOT_PASSWORD: TestPassword123!
+          MARIADB_USER: testuser
+          MARIADB_PASSWORD: TestPassword123!
+          MARIADB_DATABASE: test_sqlit
+        ports:
+          - 3307:3306
+        options: >-
+          --health-cmd "healthcheck.sh --connect --innodb_initialized"
+          --health-interval 5s
+          --health-timeout 5s
+          --health-retries 10
+          --health-start-period 30s
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python 3.12
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install MariaDB Connector/C
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y libmariadb-dev
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[test]"
+          pip install mariadb
+
+      - 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 curl -sf http://localhost:8080/health > /dev/null 2>&1; then
+              echo "CockroachDB is ready"
+              break
+            fi
+            echo "Waiting for CockroachDB... ($i/30)"
+            sleep 2
+          done
+
+      - name: Run CockroachDB integration tests
+        env:
+          COCKROACHDB_HOST: localhost
+          COCKROACHDB_PORT: 26257
+          COCKROACHDB_USER: root
+          COCKROACHDB_PASSWORD: ""
+          COCKROACHDB_DATABASE: test_sqlit
+        run: |
+          pytest tests/test_cockroachdb.py -v --timeout=120
+
+  test-ssh:
+    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: Create Docker network
+        run: docker network create ssh-test-net
+
+      - name: Start PostgreSQL
+        run: |
+          docker run -d --name postgres --network ssh-test-net \
+            -e POSTGRES_USER=testuser \
+            -e POSTGRES_PASSWORD=TestPassword123! \
+            -e POSTGRES_DB=test_sqlit \
+            -p 5433:5432 \
+            postgres:16-alpine
+          # Wait for PostgreSQL to be ready
+          for i in {1..30}; do
+            if docker exec postgres pg_isready -U testuser -d test_sqlit > /dev/null 2>&1; then
+              echo "PostgreSQL is ready"
+              break
+            fi
+            echo "Waiting for PostgreSQL... ($i/30)"
+            sleep 2
+          done
+
+      - name: Start SSH server
+        run: |
+          docker run -d --name sshserver --network ssh-test-net \
+            -e PUID=1000 \
+            -e PGID=1000 \
+            -e USER_NAME=testuser \
+            -e USER_PASSWORD=testpass \
+            -e PASSWORD_ACCESS=true \
+            -e DOCKER_MODS=linuxserver/mods:openssh-server-ssh-tunnel \
+            -p 2222:2222 \
+            lscr.io/linuxserver/openssh-server:latest
+          # Wait for SSH to be ready
+          for i in {1..30}; do
+            if nc -z localhost 2222 2>/dev/null; then
+              echo "SSH server is ready"
+              break
+            fi
+            echo "Waiting for SSH server... ($i/30)"
+            sleep 2
+          done
+
+      - name: Run SSH tunnel integration tests
+        env:
+          SSH_HOST: localhost
+          SSH_PORT: 2222
+          SSH_USER: testuser
+          SSH_PASSWORD: testpass
+          SSH_REMOTE_DB_HOST: postgres
+          SSH_REMOTE_DB_PORT: 5432
+          SSH_DIRECT_PG_HOST: localhost
+          SSH_DIRECT_PG_PORT: 5433
+          POSTGRES_USER: testuser
+          POSTGRES_PASSWORD: TestPassword123!
+          POSTGRES_DATABASE: test_sqlit
+        run: |
+          pytest tests/test_ssh.py -v --timeout=120
+
+      - name: Cleanup
+        if: always()
+        run: |
+          docker stop sshserver postgres || true
+          docker rm sshserver postgres || true
+          docker network rm ssh-test-net || true

sqlit_tui-0.4.2/.github/workflows/release.yml

@@ -0,0 +1,64 @@
+name: Release and Publish
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Extract version from tag
+        id: version
+        run: echo "VERSION=${GITHUB_REF#refs/tags/}" >> $GITHUB_OUTPUT
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v1
+        with:
+          name: ${{ steps.version.outputs.VERSION }}
+          generate_release_notes: true
+          draft: false
+          prerelease: false
+
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install build tools
+        run: python -m pip install --upgrade build
+
+      - name: Build package
+        run: python -m build
+
+      - name: Upload dist artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+    steps:
+      - name: Download dist artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

sqlit_tui-0.4.2/.gitignore

@@ -0,0 +1,28 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# Distribution / packaging
+build/
+dist/
+*.egg-info/
+*.egg
+
+# Virtual environments
+venv/
+.venv/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+
+# Demo files
+docker-compose.yml
+init.sql
+*.tape

sqlit_tui-0.4.2/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.4.2/LICENSE

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