Testing: Export cratedb_service fixture as pytest11 entrypoint

This way, for basic needs, corresponding boilerplate code does not need
to be provided by downstream projects.

When needing more configurability, you will need to define corresponding
alternative fixtures, and not use the built-in provided from.

cratedb_toolkit/testing/testcontainers/cratedb.py

@@ -16,8 +16,9 @@
 
 import logging
 import os
-from typing import Optional
+from typing import Generator, Optional
 
+import pytest
 from testcontainers.core.config import MAX_TRIES
 from testcontainers.core.generic import DbContainer
 from testcontainers.core.waiting_utils import wait_container_is_ready, wait_for_logs
@@ -212,3 +213,14 @@ def http_url(self):
         Used to stay backward compatible with the downstream code.
         """
         return self.get_http_url()
+
+
+@pytest.fixture(scope="session")
+def cratedb_service() -> Generator[CrateDBTestAdapter, None, None]:
+    """
+    Provide a CrateDB service instance to the test suite.
+    """
+    db = CrateDBTestAdapter()
+    db.start()
+    yield db
+    db.stop()

pyproject.toml

@@ -144,7 +144,6 @@ test = [
 testing = [
   "testcontainers<4",
 ]
-
 [project.urls]
 changelog = "https://github.com/crate-workbench/cratedb-toolkit/blob/main/CHANGES.rst"
 documentation = "https://github.com/crate-workbench/cratedb-toolkit"
@@ -155,6 +154,8 @@ cratedb-retention = "cratedb_toolkit.retention.cli:cli"
 cratedb-toolkit = "cratedb_toolkit.cli:cli"
 ctk = "cratedb_toolkit.cli:cli"
 migr8 = "cratedb_toolkit.io.mongodb.cli:main"
+[project.entry-points.pytest11]
+cratedb_service = "cratedb_toolkit.testing.testcontainers.cratedb"
 
 [tool.black]
 line-length = 120