Add HA API server with Docker support

- Add ha_api.py: async aiohttp server with ProcessPoolExecutor for
  handling hundreds of concurrent queries without timeouts
- Add Dockerfile for containerised deployment
- Add GitHub Actions docker.yml workflow for DockerHub CI/CD
- Add aiohttp dependency to requirements.txt and setup.py
- Bump version to 0.6.0

Author: Robbie1977

.github/workflows/docker.yml

@@ -0,0 +1,56 @@
+name: Docker Image CI
+
+on:
+  push:
+  release:
+    types: [published]
+  workflow_dispatch:
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+    - name: Checkout
+      uses: actions/checkout@v4
+
+    - name: Extract metadata
+      id: meta
+      run: |
+        if [[ $GITHUB_REF == refs/tags/* ]]; then
+          TAG=${GITHUB_REF#refs/tags/}
+        else
+          TAG=${GITHUB_REF#refs/heads/}
+        fi
+        echo "tag=$TAG" >> $GITHUB_OUTPUT
+
+    - name: Build test Docker image
+      run: docker build --no-cache . --file Dockerfile --tag test-image
+
+    - name: Test container startup
+      run: |
+        docker run -d --name test-container -p 8080:8080 test-image
+        sleep 10
+        if docker ps | grep -q test-container; then
+          echo "Container is running successfully"
+          curl -sf http://localhost:8080/health || { echo "Health check failed"; docker logs test-container; exit 1; }
+          echo "Health check passed"
+        else
+          echo "Container failed to start"
+          docker logs test-container
+          exit 1
+        fi
+        docker stop test-container || true
+        docker rm test-container
+
+    - name: Build Docker image
+      run: docker build . --file Dockerfile --tag virtualflybrain/vfbquery:${{ steps.meta.outputs.tag }}
+
+    - name: Login to Docker Hub
+      uses: docker/login-action@v3
+      with:
+        username: ${{ secrets.DOCKER_HUB_USER }}
+        password: ${{ secrets.DOCKER_HUB_PASSWORD }}
+
+    - name: Push Docker image
+      run: docker push virtualflybrain/vfbquery:${{ steps.meta.outputs.tag }}

Dockerfile

@@ -0,0 +1,24 @@
+FROM python:3.11-slim
+
+WORKDIR /app
+
+# Install system deps (some vfb_connect/pandas wheels need these)
+RUN apt-get update && \
+    apt-get install -y --no-install-recommends gcc g++ && \
+    rm -rf /var/lib/apt/lists/*
+
+# Install Python deps first (layer caching)
+COPY requirements.txt setup.py pyproject.toml README.md ./
+COPY src/ src/
+RUN pip install --no-cache-dir aiohttp && \
+    pip install --no-cache-dir -e .
+
+EXPOSE 8080
+
+# Tuning via env vars:
+#   VFBQUERY_PORT          (default 8080)
+#   VFBQUERY_HOST          (default 0.0.0.0)
+#   VFBQUERY_WORKERS       (default: CPU count)
+#   VFBQUERY_MAX_CONCURRENT (default: workers × 4)
+
+ENTRYPOINT ["python", "-m", "vfbquery.ha_api"]

requirements.txt

@@ -3,4 +3,5 @@ dataclasses-json
 dacite
 requests
 pysolr
-get_version
+get_version
+aiohttp

setup.py

@@ -3,7 +3,7 @@
 
 here = path.abspath(path.dirname(__file__))
 
-__version__ = "0.5.9"
+__version__ = "0.6.0"
 
 # Get the long description from the README file
 with open(path.join(here, 'README.md')) as f:
@@ -30,7 +30,8 @@
         "pysolr",
         "pandas",
         "marshmallow",
-        "vfb_connect"
+        "vfb_connect",
+        "aiohttp",
     ],
     python_requires=">=3.7",
     project_urls={  # Optional

src/vfbquery/__init__.py

@@ -95,4 +95,4 @@ def clear_solr_cache(query_type: str, term_id: str) -> bool:
     __solr_caching_available__ = False
 
 # Version information
-__version__ = "0.5.9"
+__version__ = "0.6.0"