docs(tests): add detailed docstrings to _worker_schema_name and _build_worker_url unit tests

Author: Borda

tests/test_conftest_helpers.py

@@ -1,36 +1,41 @@
 """Unit tests for private helpers in tests/conftest.py."""
 
-import pytest
-
 from tests.conftest import _build_worker_url, _worker_schema_name
 
 
 class TestWorkerSchemaName:
     def test_valid_gw0(self):
+        """Return a schema name for the first xdist worker."""
         assert _worker_schema_name("gw0") == "test_worker_0"
 
     def test_valid_gw99(self):
+        """Return a schema name for multi-digit xdist workers."""
         assert _worker_schema_name("gw99") == "test_worker_99"
 
     def test_master_returns_none(self):
+        """Return ``None`` when pytest is not running under xdist."""
         assert _worker_schema_name("master") is None
 
     def test_non_gw_id_returns_none(self):
+        """Ignore worker IDs that do not match the xdist pattern."""
         assert _worker_schema_name("worker1") is None
 
     def test_partial_match_returns_none(self):
+        """Require a full worker ID match before creating a schema name."""
         # "gw0extra" should not match the fullmatch pattern
         assert _worker_schema_name("gw0extra") is None
 
 
 class TestBuildWorkerUrl:
     def test_url_without_options(self):
+        """Add a search path option when the URL has no existing options."""
         url = "postgresql://user:pass@localhost/testdb"
         result = _build_worker_url(url, "test_worker_0")
         assert "options" in result
         assert "search_path%3Dtest_worker_0" in result or "search_path=test_worker_0" in result
 
     def test_url_with_existing_options_appends(self):
+        """Append the worker search path to existing connection options."""
         url = "postgresql://user:pass@localhost/testdb?options=-cstatement_timeout%3D5000"
         result = _build_worker_url(url, "test_worker_1")
         # The new search_path must be present