implement UUID parameter binding

Author: Eugene Shershen

.github/workflows/ci.yml

@@ -11,6 +11,20 @@ jobs:
   test:
     name: test
     runs-on: ${{ matrix.os }}
+    services:
+      postgres:
+        image: postgres:15
+        env:
+          POSTGRES_PASSWORD: password
+          POSTGRES_USER: postgres
+          POSTGRES_DB: test_db
+        options: >-
+          --health-cmd pg_isready
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+        ports:
+          - 5432:5432
     strategy:
       matrix:
         build: [linux_3.8, linux_3.9, linux_3.10, linux_3.11, linux_3.13, windows_3.9, windows_3.13, mac_3.9, mac_3.13]
@@ -56,9 +70,21 @@ jobs:
         python -m pip install --upgrade pip wheel
         pip install -e ".[dev]"
 
+    - name: Run tests (with PostgreSQL on Linux)
+      if: startsWith(matrix.build, 'linux')
+      run: python -m pytest tests/ -v
+      env:
+        DATABASE_URL: postgresql+psqlpy://postgres:password@localhost:5432/test_db
+
+    - name: Run tests (without PostgreSQL on Windows/Mac)
+      if: "!startsWith(matrix.build, 'linux')"
+      run: python -m pytest tests/ -v
+
     - name: Produce coverage report
       if: matrix.build == 'linux_3.9'
       run: pytest --cov=psqlpy_sqlalchemy --cov-report=xml
+      env:
+        DATABASE_URL: postgresql+psqlpy://postgres:password@localhost:5432/test_db
 
     - name: Upload coverage report
       if: matrix.build == 'linux_3.9'

psqlpy_sqlalchemy/__init__.py

@@ -2,5 +2,5 @@
 
 PsqlpyDialect = PSQLPyAsyncDialect
 
-__version__ = "0.1.0a7"
+__version__ = "0.1.0a8"
 __all__ = ["PsqlpyDialect", "PSQLPyAsyncDialect"]

psqlpy_sqlalchemy/dialect.py

@@ -1,10 +1,11 @@
 import typing as t
+import uuid
 from types import ModuleType
 from typing import Any, Dict, MutableMapping, Sequence, Tuple
 
 import psqlpy
 from sqlalchemy import URL, util
-from sqlalchemy.dialects.postgresql.base import INTERVAL, PGDialect
+from sqlalchemy.dialects.postgresql.base import INTERVAL, UUID, PGDialect
 from sqlalchemy.dialects.postgresql.json import JSONPathType
 from sqlalchemy.pool import AsyncAdaptedQueuePool, NullPool
 from sqlalchemy.sql import operators, sqltypes
@@ -218,6 +219,29 @@ class _PGNullType(sqltypes.NullType):
     render_bind_cast = True
 
 
+class _PGUUID(UUID):
+    """PostgreSQL UUID type with proper parameter binding for psqlpy."""
+
+    def bind_processor(self, dialect):
+        """Process UUID parameters for psqlpy compatibility."""
+
+        def process(value):
+            if value is None:
+                return None
+            if isinstance(value, uuid.UUID):
+                return str(value)
+            if isinstance(value, str):
+                # Validate that it's a proper UUID string
+                try:
+                    uuid.UUID(value)
+                    return value
+                except ValueError:
+                    raise ValueError(f"Invalid UUID string: {value}")
+            return str(value)
+
+        return process
+
+
 class PSQLPyAsyncDialect(PGDialect):
     driver = "psqlpy"
     is_async = True
@@ -264,6 +288,7 @@ class PSQLPyAsyncDialect(PGDialect):
             sqltypes.SmallInteger: _PGSmallInteger,
             sqltypes.BigInteger: _PGBigInteger,
             sqltypes.Boolean: _PGBoolean,
+            UUID: _PGUUID,  # UUID support with proper parameter binding
             # Note: NullType mapping removed - standard PostgreSQL dialect doesn't map it
             # and mapping it with render_bind_cast=True causes DDL compilation errors
         },

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "psqlpy-sqlalchemy"
-version = "0.1.0a7"
+version = "0.1.0a8"
 description = "SQLAlchemy dialect for psqlpy PostgreSQL driver"
 readme = "README.md"
 license = {text = "MIT"}
@@ -36,6 +36,7 @@ dependencies = [
 dev = [
     "pytest>=7.0.0",
     "pytest-asyncio>=0.21.0",
+    "greenlet>=1.0.0",
     "ruff>=0.1.0",
     "mypy>=1.0.0",
     "sqlmodel>=0.0.8",
@@ -112,3 +113,6 @@ ignore_errors = true
 [[tool.mypy.overrides]]
 module = "tests.*"
 ignore_errors = true
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"