feat: move Dolt to clientless validation (#125)

## Summary
- move Dolt tests to use the bundled container CLI instead of mysql.connector
- expose Dolt credential/database fixtures for user overrides
- pre-pull the Dolt image in CI so fixture startup does not pull it lazily

Includes the stacked PR #129

Author: cofin

.github/workflows/ci.yaml

@@ -28,9 +28,6 @@ jobs:
     steps:
       - uses: actions/checkout@v6
 
-      - name: Install additional dependencies
-        run: sudo apt-get update && sudo ACCEPT_EULA=Y apt-get install -y msodbcsql18 libmariadb-dev && sudo apt-get autoremove -y  && sudo apt-get clean -y
-
       - name: Set up Python ${{ matrix.python-version }}
         uses: actions/setup-python@v6
         with:
@@ -52,6 +49,7 @@ jobs:
           images=(
             "mcr.microsoft.com/azure-storage/azurite"
             "mcr.microsoft.com/mssql/server:2022-latest"
+            "dolthub/dolt-sql-server:latest"
             "postgres:11" "postgres:12" "postgres:13" "postgres:14"
             "postgres:15" "postgres:16" "postgres:17" "postgres:18"
             "pgvector/pgvector:pg15"
@@ -73,8 +71,6 @@ jobs:
             "gcr.io/cloud-spanner-emulator/emulator:latest"
             "ghcr.io/goccy/bigquery-emulator:latest"
             "gizmodata/gizmosql:latest"
-            "elasticsearch:7.17.19"
-            "elasticsearch:8.13.0"
           )
           printf '%s\n' "${images[@]}" | xargs -n1 -P6 -I{} bash -c '
             image="$1"
@@ -112,9 +108,6 @@ jobs:
   test_elasticsearch:
     runs-on: ubuntu-latest
     steps:
-      - name: Install additional dependencies
-        run: sudo ACCEPT_EULA=Y apt-get install -y msodbcsql18 libmariadb-dev
-
       - uses: actions/checkout@v6
 
       - name: Set up Python

.github/workflows/docs.yml

@@ -22,9 +22,6 @@ jobs:
     steps:
       - uses: actions/checkout@v6
 
-      - name: Install additional dependencies
-        run: sudo apt-get update && sudo ACCEPT_EULA=Y apt-get install -y msodbcsql18 libmariadb-dev && sudo apt-get autoremove -y  && sudo apt-get clean -y
-
       - name: Set up Python ${{ matrix.python-version }}
         uses: actions/setup-python@v6
         with:

.github/workflows/release.yaml

@@ -12,9 +12,6 @@ jobs:
       id-token: write
     environment: release
     steps:
-      - name: Install additional dependencies
-        run: sudo ACCEPT_EULA=Y apt-get install -y msodbcsql18 libmariadb-dev
-
       - name: Check out repository
         uses: actions/checkout@v6
 

docs/getting-started/installation.rst

@@ -27,7 +27,7 @@ To use ``pytest-databases`` with specific databases, you need to install optiona
    * - Oracle
      - ``pytest-databases[oracle]``
    * - SQL Server
-     - ``pytest-databases[sqlserver]``
+     - ``pytest-databases[mssql]``
    * - Google AlloyDB Omni
      - ``pytest-databases[alloydb]``
    * - Google Spanner

docs/supported-databases/dolt.rst

@@ -8,7 +8,9 @@ Dolt is a MySQL-compatible database that provides Git-like versioning for your d
 Installation
 ------------
 
-Dolt support is built-in and does not require any additional Python client libraries for basic service management. Since Dolt is MySQL-compatible, you can connect to the database from your tests using your preferred MySQL client (e.g., ``mysql-connector-python``).
+The fixture provides a running Dolt SQL service and validates availability with the container's bundled tools. Since
+Dolt is MySQL-compatible, use the service attributes with the MySQL client, ORM, or application configuration you
+normally use.
 
 Usage Example
 -------------
@@ -22,7 +24,6 @@ Usage Example
     pytest_plugins = ["pytest_databases.docker.dolt"]
 
     def test(dolt_service: DoltService) -> None:
-        # Create your own connection using the service fixture attributes
         with mysql.connector.connect(
             host=dolt_service.host,
             port=dolt_service.port,
@@ -38,6 +39,10 @@ Available Fixtures
 ------------------
 
 * ``dolt_service``: A fixture that provides a Dolt service (latest).
+* ``dolt_user``: The application user configured in the container.
+* ``dolt_password``: The application user password configured in the container.
+* ``dolt_root_password``: The root password configured in the container.
+* ``dolt_database``: The initial database configured in the container.
 
 Isolation Level
 ---------------

docs/supported-databases/sqlserver.rst

@@ -10,45 +10,34 @@ Installation
 
    pip install pytest-databases[mssql]
 
+The ``mssql`` extra is kept as a compatibility group. The fixture provides a running SQL Server service and validates
+availability with SQL Server's bundled tools. Install the SQL Server client library that your application already uses.
+
 Usage Example
 -------------
 
 .. code-block:: python
 
-    import pytest
-    import pymssql
+    import pyodbc
     from pytest_databases.docker.mssql import MSSQLService
 
     pytest_plugins = ["pytest_databases.docker.mssql"]
 
-    def test(mssql_service: MSSQLService) -> None:
-        conn = pymssql.connect(
-            host=mssql_service.host,
-            port=str(mssql_service.port),
-            database=mssql_service.database,
-            user=mssql_service.user,
-            password=mssql_service.password,
-            timeout=2,
-        )
-        with conn.cursor() as cursor:
-            cursor.execute("select 1 as is_available")
-            resp = cursor.fetchone()
-            assert resp is not None and resp[0] == 1
-
-    def test(mssql_connection: pymssql.Connection) -> None:
-        with mssql_connection.cursor() as cursor:
-            cursor.execute("CREATE view simple_table as SELECT 1 as the_value")
-            cursor.execute("select * from simple_table")
-            result = cursor.fetchall()
-            assert result is not None and result[0][0] == 1
-            cursor.execute("drop view simple_table")
+    def test_sql_server_service(mssql_service: MSSQLService) -> None:
+        with pyodbc.connect(mssql_service.connection_string) as conn:
+            cursor = conn.cursor()
+            cursor.execute("SELECT 1 AS is_available")
+            row = cursor.fetchone()
+            assert row is not None and row[0] == 1
 
 Available Fixtures
 ------------------
 
 * ``mssql_image``: The Docker image to use for SQL Server.
+* ``mssql_user``: The SQL Server user exposed on ``mssql_service``.
+* ``mssql_password``: The SQL Server password exposed on ``mssql_service``.
+* ``mssql_database``: The database created for ``mssql_service``.
 * ``mssql_service``: A fixture that provides a SQL Server service.
-* ``mssql_connection``: A fixture that provides a SQL Server connection.
 
 Service API
 -----------

pyproject.toml

@@ -69,7 +69,7 @@ gizmosql = ["adbc-driver-flightsql", "pyarrow"]
 keydb = ["redis"]
 mariadb = []
 mongodb = ["pymongo"]
-mssql = ["pymssql"]
+mssql = []
 mysql = []
 oracle = ["oracledb"]
 postgres = ["psycopg>=3"]

src/pytest_databases/docker/dolt.py

@@ -34,19 +34,38 @@ def platform() -> str:
     return "linux/x86_64"
 
 
+@pytest.fixture(scope="session")
+def dolt_user() -> str:
+    return os.getenv("DOLT_USER", "app")
+
+
+@pytest.fixture(scope="session")
+def dolt_password() -> str:
+    return os.getenv("DOLT_PASSWORD", "super-secret")
+
+
+@pytest.fixture(scope="session")
+def dolt_root_password() -> str:
+    return os.getenv("DOLT_ROOT_PASSWORD", "super-secret")
+
+
+@pytest.fixture(scope="session")
+def dolt_database() -> str:
+    return os.getenv("DOLT_DATABASE", "db")
+
+
 @contextlib.contextmanager
 def _provide_dolt_service(
     docker_service: DockerService,
     image: str,
     name: str,
     isolation_level: XdistIsolationLevel,
     platform: str,
+    user: str,
+    password: str,
+    root_password: str,
+    database: str,
 ) -> Generator[DoltService, None, None]:
-    user = os.getenv("DOLT_USER", "app")
-    password = os.getenv("DOLT_PASSWORD", "super-secret")
-    root_password = os.getenv("DOLT_ROOT_PASSWORD", "super-secret")
-    database = os.getenv("DOLT_DATABASE", "db")
-
     def check(_service: ServiceContainer) -> bool:
         container_name = f"pytest_databases_{name}"
         container = docker_service._get_container(container_name)
@@ -121,12 +140,20 @@ def dolt_service(
     docker_service: DockerService,
     xdist_dolt_isolation_level: XdistIsolationLevel,
     platform: str,
+    dolt_user: str,
+    dolt_password: str,
+    dolt_root_password: str,
+    dolt_database: str,
 ) -> Generator[DoltService, None, None]:
     with _provide_dolt_service(
         image="dolthub/dolt-sql-server:latest",
         name="dolt",
         docker_service=docker_service,
         isolation_level=xdist_dolt_isolation_level,
         platform=platform,
+        user=dolt_user,
+        password=dolt_password,
+        root_password=dolt_root_password,
+        database=dolt_database,
     ) as service:
         yield service