# Copyright (c) "Neo4j" # Neo4j Sweden AB [https://neo4j.com] # # # Licensed under the Apache License, Version 2.0 (the "License"); # you may not use this file except in compliance with the License. # You may obtain a copy of the License at # # # https://www.apache.org/licenses/LICENSE-2.0 # # # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. # See the License for the specific language governing permissions and # limitations under the License. from unittest.mock import MagicMock, Mock, patch import pytest from tenacity import RetryError from neo4j_graphrag.embeddings.vertexai import VertexAIEmbeddings from neo4j_graphrag.exceptions import EmbeddingsGenerationError @patch("neo4j_graphrag.embeddings.vertexai.TextEmbeddingModel", None) def test_vertexai_embedder_missing_dependency() -> None: with pytest.raises(ImportError): VertexAIEmbeddings() @patch("neo4j_graphrag.embeddings.vertexai.TextEmbeddingModel") def test_vertexai_embedder_happy_path(mock_vertexai: Mock) -> None: mock_vertexai.from_pretrained.return_value.get_embeddings.return_value = [ MagicMock(values=[1.0, 2.0]) ] embedder = VertexAIEmbeddings() res = embedder.embed_query("my text") assert isinstance(res, list) assert res == [1.0, 2.0] @patch("neo4j_graphrag.embeddings.vertexai.TextEmbeddingModel") def test_vertexai_embedder_non_retryable_error_handling(mock_vertexai: Mock) -> None: """Test that non-retryable errors fail immediately without retries.""" mock_embeddings = mock_vertexai.from_pretrained.return_value.get_embeddings mock_embeddings.side_effect = Exception("API Error") embedder = VertexAIEmbeddings() with pytest.raises( EmbeddingsGenerationError, match="Failed to generate embedding with VertexAI" ): embedder.embed_query("my text") # Verify the API was called only once (no retries for non-rate-limit errors) assert mock_embeddings.call_count == 1 @patch("neo4j_graphrag.embeddings.vertexai.TextEmbeddingModel") def test_vertexai_embedder_rate_limit_error_retries(mock_vertexai: Mock) -> None: """Test that rate limit errors are retried the expected number of times.""" # Rate limit error that should trigger retries (matches "resource exhausted" pattern) mock_embeddings = mock_vertexai.from_pretrained.return_value.get_embeddings mock_embeddings.side_effect = [ Exception("resource exhausted - quota exceeded"), Exception("resource exhausted - quota exceeded"), Exception("resource exhausted - quota exceeded"), ] embedder = VertexAIEmbeddings() # After exhausting retries, tenacity raises RetryError with pytest.raises(RetryError): embedder.embed_query("my text") # Verify the API was called 3 times (default max_attempts for RetryRateLimitHandler) assert mock_embeddings.call_count == 3 @patch("neo4j_graphrag.embeddings.vertexai.TextEmbeddingModel") def test_vertexai_embedder_rate_limit_error_eventual_success( mock_vertexai: Mock, ) -> None: """Test that rate limit errors eventually succeed after retries.""" # First two calls fail with rate limit, third succeeds mock_embeddings = mock_vertexai.from_pretrained.return_value.get_embeddings mock_embeddings.side_effect = [ Exception("resource exhausted - quota exceeded"), Exception("resource exhausted - quota exceeded"), [MagicMock(values=[1.0, 2.0])], ] embedder = VertexAIEmbeddings() result = embedder.embed_query("my text") # Verify successful result assert result == [1.0, 2.0] # Verify the API was called 3 times before succeeding assert mock_embeddings.call_count == 3