turbodbc: Add software test launcher and CI configuration

Author: amotl

.github/dependabot.yml

@@ -88,6 +88,11 @@ updates:
     schedule:
       interval: "daily"
 
+  - directory: "/by-language/python-turbodbc"
+    package-ecosystem: "pip"
+    schedule:
+      interval: "daily"
+
   - directory: "/by-language/ruby"
     package-ecosystem: "bundler"
     schedule:

.github/workflows/lang-python-turbodbc.yml

@@ -0,0 +1,63 @@
+name: Python turbodbc
+
+on:
+  pull_request:
+    branches: ~
+    paths:
+    - '.github/workflows/lang-python-turbodbc.yml'
+    - 'by-language/python-turbodbc/**'
+    - '/requirements.txt'
+  push:
+    branches: [ main ]
+    paths:
+    - '.github/workflows/lang-python-turbodbc.yml'
+    - 'by-language/python-turbodbc/**'
+    - '/requirements.txt'
+
+  # Allow job to be triggered manually.
+  workflow_dispatch:
+
+  # Run job each night after CrateDB nightly has been published.
+  schedule:
+    - cron: '0 3 * * *'
+
+# Cancel in-progress jobs when pushing to the same branch.
+concurrency:
+  cancel-in-progress: true
+  group: ${{ github.workflow }}-${{ github.ref }}
+
+jobs:
+  test:
+    name: "
+     CrateDB: ${{ matrix.cratedb-version }}
+     on ${{ matrix.os }}"
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ 'ubuntu-22.04' ]
+        cratedb-version: [ 'nightly' ]
+
+    services:
+      cratedb:
+        image: crate/crate:${{ matrix.cratedb-version }}
+        ports:
+          - 4200:4200
+          - 5432:5432
+        env:
+          CRATE_HEAP_SIZE: 4g
+
+    steps:
+
+      - name: Acquire sources
+        uses: actions/checkout@v4
+
+      - name: Install prerequisites
+        run: |
+          cd by-language/python-turbodbc
+          docker build --tag local/turbodbc-ci --file=dockerfiles/debian.Dockerfile .
+
+      - name: Validate by-language/python-turbodbc
+        run: |
+          cd by-language/python-turbodbc
+          docker run --rm --volume=$(pwd):/src --network=host local/turbodbc-ci python3 /src/demo.py

by-language/python-turbodbc/dockerfiles/debian.Dockerfile

@@ -33,6 +33,9 @@ RUN apt-get install --yes \
     libarrow-flight-sql-dev libgandiva-dev libparquet-dev
 
 # Install ultra-fast Unicode routines.
+# TODO: The version number here would need to be bumped, in order to validate
+#       against new upstream releases. The Debian OCI image (this one) has been
+#       selected to run on CI/GHA.
 RUN true \
     && git clone https://github.com/simdutf/simdutf --branch=v6.4.0 \
     && cd simdutf \

by-language/python-turbodbc/pyproject.toml

@@ -1,7 +1,15 @@
-[tool.black]
-line-length = 120
+[tool.pytest.ini_options]
+minversion = "2.0"
+addopts = """
+  -rfEX -p pytester --strict-markers --verbosity=3
+  --capture=no
+  """
+log_level = "DEBUG"
+log_cli_level = "DEBUG"
+testpaths = ["*.py"]
+xfail_strict = true
+markers = [
+]
 
-[tool.isort]
-profile = "black"
-skip_glob = "**/site-packages/**"
-skip_gitignore = false
+[tool.ruff]
+line-length = 100

by-language/python-turbodbc/requirements-dev.txt

@@ -0,0 +1 @@
+pytest<9

by-language/python-turbodbc/test.py

@@ -0,0 +1,12 @@
+import shlex
+import subprocess
+import pytest
+
+
+def run(command: str):
+    subprocess.check_call(shlex.split(command))
+
+
+def test_demo():
+    cmd = "time python demo.py"
+    run(cmd)