test(api_call): add tests for API call parameter normalization and node selection

- Implement tests for `ApiCall.normalize_params` to ensure correct
  handling of non-dictionary inputs and mixed data types, improving
  input validation and robustness.
- Add tests for node selection logic in `ApiCall`:
  - Verify behavior when no healthy nodes are available, ensuring
    proper logging and fallback node selection.
  - Ensure exception is raised when no nodes are healthy during a
    request.
- Add a docstring to `tests/__init__.py` to clarify the purpose of
  the tests module.

These tests enhance coverage and ensure stability in key areas of
the API call logic.

Author: tharropoulos

tests/api_call_test.py

@@ -2,9 +2,12 @@
 
 from __future__ import annotations
 
+import logging
 import sys
 import time
 
+from pytest_mock import MockFixture
+
 if sys.version_info >= (3, 11):
     import typing
 else:
@@ -19,6 +22,7 @@
 from typesense import exceptions
 from typesense.api_call import ApiCall
 from typesense.configuration import Configuration, Node
+from typesense.logger import logger
 
 
 @pytest.fixture(scope="function", name="config")
@@ -142,6 +146,14 @@ def test_normalize_params_with_booleans() -> None:
     assert parameter_dict == {"key1": "true", "key2": "false"}
 
 
+def test_normalize_params_with_non_dict() -> None:
+    """Test that it raises when a non-dictionary is passed."""
+    parameter_non_dict = "string"
+
+    with pytest.raises(ValueError):
+        ApiCall.normalize_params(parameter_non_dict)
+
+
 def test_normalize_params_with_mixed_types() -> None:
     """Test that it correctly normalizes boolean values to strings."""
     parameter_dict = {"key1": True, "key2": False, "key3": "value", "key4": 123}
@@ -438,6 +450,32 @@ def test_selects_next_available_node_on_timeout(
         assert request_mocker.call_count == 3
 
 
+def test_get_node_no_healthy_nodes(
+    api_call: ApiCall,
+    mocker: MockFixture,
+    caplog: pytest.LogCaptureFixture,
+) -> None:
+    """Test that it logs a message if no healthy nodes are found."""
+    for api_node in api_call.nodes:
+        api_node.healthy = False
+
+    api_call.config.nearest_node.healthy = False
+
+    mocker.patch.object(api_call, "node_due_for_health_check", return_value=False)
+
+    # Need to set the logger level to DEBUG to capture the message
+    logger.setLevel(logging.DEBUG)
+
+    selected_node = api_call.get_node()
+
+    with caplog.at_level(logging.DEBUG):
+        assert "No healthy nodes were found. Returning the next node." in caplog.text
+
+    assert selected_node == api_call.nodes[api_call.node_index]
+
+    assert api_call.node_index == 0
+
+
 def test_raises_if_no_nodes_are_healthy_with_the_last_exception(
     api_call: ApiCall,
 ) -> None: