File size: 11,239 Bytes
38c016b
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
486eff6
38c016b
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
486eff6
38c016b
 
 
 
 
 
 
 
 
 
 
 
 
486eff6
38c016b
 
 
 
 
 
 
 
 
 
486eff6
38c016b
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
486eff6
38c016b
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
486eff6
38c016b
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
"""
Unit tests for API routes.
"""

import pytest
import asyncio
from unittest.mock import Mock, patch, AsyncMock
from fastapi.testclient import TestClient
from fastapi import FastAPI
import sys
from pathlib import Path

# Add project root to path for imports
project_root = Path(__file__).parent.parent
sys.path.insert(0, str(project_root))

from src.routes.api import router, get_crossword_generator
from src.services.crossword_generator_wrapper import CrosswordGenerator


@pytest.fixture
def mock_vector_service():
    """Mock vector search service."""
    mock_service = Mock()
    mock_service.is_initialized = True
    mock_service.find_similar_words = AsyncMock(return_value=[
        {"word": "ELEPHANT", "clue": "Large mammal", "similarity": 0.8, "source": "vector_search"},
        {"word": "TIGER", "clue": "Striped cat", "similarity": 0.7, "source": "vector_search"},
    ])
    return mock_service


@pytest.fixture
def mock_crossword_generator():
    """Mock crossword generator."""
    mock_gen = Mock(spec=CrosswordGenerator)
    mock_gen.generate_puzzle = AsyncMock(return_value={
        "grid": [["T", "E", "S", "T"], [".", ".", ".", "."]],
        "clues": [
            {
                "number": 1,
                "word": "TEST",
                "text": "A test word",
                "direction": "across",
                "position": {"row": 0, "col": 0}
            }
        ],
        "metadata": {
            "topics": ["Animals"],
            "difficulty": "medium",
            "wordCount": 1,
            "size": 2,
            "aiGenerated": True
        }
    })
    mock_gen.generate_words_for_topics = AsyncMock(return_value=[
        {"word": "ELEPHANT", "clue": "Large mammal", "similarity": 0.8, "source": "vector_search"},
        {"word": "TIGER", "clue": "Striped cat", "similarity": 0.7, "source": "vector_search"},
    ])
    return mock_gen


@pytest.fixture
def test_app(mock_vector_service):
    """Create test FastAPI app."""
    app = FastAPI()
    app.include_router(router, prefix="/api")
    
    # Mock the app state
    app.state.vector_service = mock_vector_service
    
    return app


@pytest.fixture
def client(test_app):
    """Create test client."""
    return TestClient(test_app)


class TestAPIRoutes:
    """Test cases for API routes."""

    def test_get_topics(self, client):
        """Test GET /api/topics endpoint."""
        response = client.get("/api/topics")
        
        assert response.status_code == 200
        topics = response.json()
        
        assert len(topics) == 4
        assert all("id" in topic and "name" in topic for topic in topics)
        
        # Check specific topics
        topic_ids = [topic["id"] for topic in topics]
        assert "animals" in topic_ids
        assert "geography" in topic_ids
        assert "science" in topic_ids
        assert "technology" in topic_ids

    def test_generate_puzzle_success(self, client, mock_crossword_generator):
        """Test successful puzzle generation."""
        with patch('src.routes.api.generator', mock_crossword_generator):
            response = client.post("/api/generate", json={
                "topics": ["Animals"],
                "difficulty": "medium"
            })
            
            assert response.status_code == 200
            puzzle = response.json()
            
            assert "grid" in puzzle
            assert "clues" in puzzle
            assert "metadata" in puzzle
            assert puzzle["metadata"]["topics"] == ["Animals"]
            assert puzzle["metadata"]["difficulty"] == "medium"
            assert puzzle["metadata"]["aiGenerated"] is True

    def test_generate_puzzle_no_topics(self, client):
        """Test puzzle generation with no topics."""
        response = client.post("/api/generate", json={
            "topics": [],
            "difficulty": "medium",
        })
        
        assert response.status_code == 400
        assert "At least one topic is required" in response.json()["detail"]

    def test_generate_puzzle_invalid_difficulty(self, client):
        """Test puzzle generation with invalid difficulty."""
        response = client.post("/api/generate", json={
            "topics": ["Animals"],
            "difficulty": "impossible",
        })
        
        assert response.status_code == 400
        assert "Invalid difficulty" in response.json()["detail"]

    def test_generate_puzzle_generator_failure(self, client):
        """Test puzzle generation when generator fails."""
        mock_gen = Mock(spec=CrosswordGenerator)
        mock_gen.generate_puzzle = AsyncMock(return_value=None)
        
        with patch('src.routes.api.generator', mock_gen):
            response = client.post("/api/generate", json={
                "topics": ["Animals"],
                "difficulty": "medium"
            })
            
            assert response.status_code == 500
            assert "Failed to generate puzzle" in response.json()["detail"]

    def test_generate_puzzle_generator_exception(self, client):
        """Test puzzle generation when generator raises exception."""
        mock_gen = Mock(spec=CrosswordGenerator)
        mock_gen.generate_puzzle = AsyncMock(side_effect=Exception("Test error"))
        
        with patch('src.routes.api.generator', mock_gen):
            response = client.post("/api/generate", json={
                "topics": ["Animals"],
                "difficulty": "medium"
            })
            
            assert response.status_code == 500
            assert "Test error" in response.json()["detail"]

    def test_generate_words_success(self, client, mock_crossword_generator):
        """Test successful word generation."""
        with patch('src.routes.api.generator', mock_crossword_generator):
            response = client.post("/api/words", json={
                "topics": ["Animals"],
                "difficulty": "medium"
            })
            
            assert response.status_code == 200
            result = response.json()
            
            assert result["topics"] == ["Animals"]
            assert result["difficulty"] == "medium"
            assert "wordCount" in result
            assert "words" in result
            assert len(result["words"]) > 0

    def test_generate_words_failure(self, client):
        """Test word generation failure."""
        mock_gen = Mock(spec=CrosswordGenerator)
        mock_gen.generate_words_for_topics = AsyncMock(side_effect=Exception("Word generation failed"))
        
        with patch('src.routes.api.generator', mock_gen):
            response = client.post("/api/words", json={
                "topics": ["Animals"],
                "difficulty": "medium"
            })
            
            assert response.status_code == 500
            assert "Word generation failed" in response.json()["detail"]

    def test_api_health(self, client):
        """Test API health check."""
        response = client.get("/api/health")
        
        assert response.status_code == 200
        health = response.json()
        
        assert health["status"] == "healthy"
        assert health["backend"] == "python"
        assert health["version"] == "2.0.0"
        assert "timestamp" in health

    def test_debug_vector_search_success(self, client, mock_vector_service):
        """Test debug vector search endpoint."""
        response = client.get("/api/debug/vector-search?topic=Animals&difficulty=medium&max_words=5")
        
        assert response.status_code == 200
        result = response.json()
        
        assert result["topic"] == "Animals"
        assert result["difficulty"] == "medium"
        assert result["max_words"] == 5
        assert "found_words" in result
        assert "words" in result

    def test_debug_vector_search_service_unavailable(self, client):
        """Test debug vector search when service unavailable."""
        # Create app without vector service
        app = FastAPI()
        app.include_router(router, prefix="/api")
        app.state.vector_service = None
        
        with TestClient(app) as test_client:
            response = test_client.get("/api/debug/vector-search?topic=Animals")
            
            assert response.status_code == 503
            assert "Vector search service not available" in response.json()["detail"]

    def test_debug_vector_search_not_initialized(self, client):
        """Test debug vector search when service not initialized."""
        mock_service = Mock()
        mock_service.is_initialized = False
        
        # Create app with uninitialized service
        app = FastAPI()
        app.include_router(router, prefix="/api")
        app.state.vector_service = mock_service
        
        with TestClient(app) as test_client:
            response = test_client.get("/api/debug/vector-search?topic=Animals")
            
            assert response.status_code == 503
            assert "Vector search service not available" in response.json()["detail"]

    def test_debug_vector_search_failure(self, client, mock_vector_service):
        """Test debug vector search when search fails."""
        mock_vector_service.find_similar_words = AsyncMock(side_effect=Exception("Search failed"))
        
        response = client.get("/api/debug/vector-search?topic=Animals")
        
        assert response.status_code == 500
        assert "Search failed" in response.json()["detail"]

    def test_get_crossword_generator_dependency(self, mock_vector_service):
        """Test the crossword generator dependency."""
        # Mock request with vector service
        mock_request = Mock()
        mock_request.app.state.vector_service = mock_vector_service
        
        with patch('src.routes.api.generator', None):  # Reset global generator
            generator = get_crossword_generator(mock_request)
            
            assert isinstance(generator, CrosswordGenerator)
            assert generator.vector_service == mock_vector_service

    def test_request_validation(self, client):
        """Test request model validation."""
        # Test missing required fields
        response = client.post("/api/generate", json={})
        assert response.status_code == 422  # Validation error
        
        # Test invalid field types
        response = client.post("/api/generate", json={
            "topics": "not_a_list",
            "difficulty": "medium",
        })
        assert response.status_code == 422  # Validation error

    def test_default_values(self, client, mock_crossword_generator):
        """Test request model default values."""
        with patch('src.routes.api.generator', mock_crossword_generator):
            response = client.post("/api/generate", json={
                "topics": ["Animals"]
                # difficulty should use defaults
            })
            
            assert response.status_code == 200
            
            # Check that defaults were used
            mock_crossword_generator.generate_puzzle.assert_called_once_with(
                topics=["Animals"],
                difficulty="medium",  # Default value
            )


if __name__ == "__main__":
    pytest.main([__file__, "-v"])