File size: 9,404 Bytes
7a05808
 
 
e4a41fa
 
 
 
7a05808
 
 
e4a41fa
7a05808
e4a41fa
7a05808
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
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
"""Tests for GoogleCacheOptimizer."""

from datetime import datetime, timedelta

import pytest

from headroom.cache import CacheConfig, GoogleCacheOptimizer, OptimizationContext
from headroom.cache.base import CacheStrategy
from headroom.cache.google import (
    GOOGLE_CACHE_DISCOUNT,
    GOOGLE_MIN_CACHE_TOKENS,
    CacheabilityAnalysis,
    CachedContentInfo,
)


class TestGoogleCacheOptimizer:
    """Test GoogleCacheOptimizer functionality."""

    @pytest.fixture
    def optimizer(self):
        """Create optimizer instance."""
        return GoogleCacheOptimizer()

    @pytest.fixture
    def context(self):
        """Create optimization context."""
        return OptimizationContext(
            provider="google",
            model="gemini-1.5-pro",
        )

    def test_optimizer_properties(self, optimizer):
        """Test optimizer properties."""
        assert optimizer.name == "google-cached-content"
        assert optimizer.provider == "google"
        assert optimizer.strategy == CacheStrategy.CACHED_CONTENT

    def test_enforces_minimum_tokens(self):
        """Test that Google's minimum is enforced."""
        config = CacheConfig(min_cacheable_tokens=100)
        optimizer = GoogleCacheOptimizer(config)
        assert optimizer.config.min_cacheable_tokens >= GOOGLE_MIN_CACHE_TOKENS

    def test_optimize_below_threshold(self, optimizer, context):
        """Test optimization with content below threshold."""
        messages = [
            {"role": "system", "content": "Short system prompt."},
            {"role": "user", "content": "Hello!"},
        ]

        result = optimizer.optimize(messages, context)

        assert result.metrics.cacheable_tokens < GOOGLE_MIN_CACHE_TOKENS
        assert any("32K" in w for w in result.warnings)

    def test_optimize_above_threshold(self, optimizer, context):
        """Test optimization with content above threshold."""
        # Create content above 32K tokens
        messages = [
            {"role": "system", "content": "You are helpful. " * 15000},
            {"role": "user", "content": "Hello!"},
        ]

        result = optimizer.optimize(messages, context)

        assert result.metrics.cacheable_tokens > 0
        if result.metrics.cacheable_tokens >= GOOGLE_MIN_CACHE_TOKENS:
            assert result.metrics.estimated_savings_percent == GOOGLE_CACHE_DISCOUNT * 100

    def test_analyze_cacheability(self, optimizer, context):
        """Test cacheability analysis."""
        messages = [
            {"role": "system", "content": "Short"},
            {"role": "user", "content": "Hello!"},
        ]

        analysis = optimizer.analyze_cacheability(messages, context)

        assert isinstance(analysis, CacheabilityAnalysis)
        assert analysis.total_tokens > 0
        assert analysis.tokens_below_minimum > 0
        assert analysis.is_cacheable is False
        assert len(analysis.recommendations) > 0

    def test_cache_registration(self, optimizer):
        """Test registering a cache."""
        cache_info = optimizer.register_cache(
            cache_id="test-cache-123",
            content_hash="abc123",
            token_count=50000,
            expires_at=datetime.now() + timedelta(hours=1),
        )

        assert cache_info.cache_id == "test-cache-123"
        assert cache_info.content_hash == "abc123"
        assert cache_info.token_count == 50000
        assert not cache_info.is_expired
        assert cache_info.ttl_remaining_seconds > 0

    def test_cache_lookup(self, optimizer):
        """Test looking up a registered cache."""
        optimizer.register_cache(
            cache_id="test-cache-456",
            content_hash="def456",
            token_count=50000,
            expires_at=datetime.now() + timedelta(hours=1),
        )

        found = optimizer.get_reusable_cache("def456")
        assert found is not None
        assert found.cache_id == "test-cache-456"

    def test_cache_lookup_expired(self, optimizer):
        """Test that expired caches are not returned."""
        optimizer.register_cache(
            cache_id="expired-cache",
            content_hash="expired123",
            token_count=50000,
            expires_at=datetime.now() - timedelta(hours=1),
        )

        found = optimizer.get_reusable_cache("expired123")
        assert found is None

    def test_cache_lookup_insufficient_ttl(self, optimizer):
        """Test that caches with insufficient TTL are not returned."""
        optimizer.register_cache(
            cache_id="short-ttl-cache",
            content_hash="shortttl123",
            token_count=50000,
            expires_at=datetime.now() + timedelta(seconds=30),
        )

        # Default min_ttl is 60 seconds
        found = optimizer.get_reusable_cache("shortttl123")
        assert found is None

    def test_extend_cache_ttl(self, optimizer):
        """Test extending cache TTL."""
        optimizer.register_cache(
            cache_id="extend-cache",
            content_hash="extend123",
            token_count=50000,
            expires_at=datetime.now() + timedelta(hours=1),
        )

        new_expires = datetime.now() + timedelta(hours=2)
        updated = optimizer.extend_cache_ttl("extend-cache", new_expires)

        assert updated is not None
        assert updated.expires_at == new_expires

    def test_remove_cache(self, optimizer):
        """Test removing a cache."""
        optimizer.register_cache(
            cache_id="remove-cache",
            content_hash="remove123",
            token_count=50000,
            expires_at=datetime.now() + timedelta(hours=1),
        )

        removed = optimizer.remove_cache("remove-cache")
        assert removed is True

        found = optimizer.get_reusable_cache("remove123")
        assert found is None

    def test_cleanup_expired_caches(self, optimizer):
        """Test cleaning up expired caches."""
        # Register expired cache
        optimizer.register_cache(
            cache_id="cleanup-expired",
            content_hash="cleanup123",
            token_count=50000,
            expires_at=datetime.now() - timedelta(hours=1),
        )

        expired_ids = optimizer.cleanup_expired_caches()
        assert "cleanup-expired" in expired_ids

    def test_list_caches(self, optimizer):
        """Test listing caches."""
        optimizer.register_cache(
            cache_id="list-cache-1",
            content_hash="list1",
            token_count=50000,
            expires_at=datetime.now() + timedelta(hours=1),
        )
        optimizer.register_cache(
            cache_id="list-cache-2",
            content_hash="list2",
            token_count=50000,
            expires_at=datetime.now() + timedelta(hours=2),
        )

        caches = optimizer.list_caches()
        assert len(caches) >= 2

    def test_get_statistics(self, optimizer):
        """Test getting statistics."""
        optimizer.register_cache(
            cache_id="stats-cache",
            content_hash="stats123",
            token_count=50000,
            expires_at=datetime.now() + timedelta(hours=1),
        )

        stats = optimizer.get_statistics()
        assert "active_caches" in stats
        assert "caches_created" in stats
        assert stats["caches_created"] >= 1

    def test_prepare_cache_creation(self, optimizer, context):
        """Test preparing cache creation parameters."""
        messages = [
            {"role": "system", "content": "You are helpful. " * 15000},
            {"role": "user", "content": "Hello!"},
        ]

        params = optimizer.prepare_cache_creation(messages, context)

        if params is not None:
            assert "contents" in params
            assert "ttl" in params
            assert "display_name" in params

    def test_build_request_with_cache(self, optimizer):
        """Test building request with cache."""
        messages = [
            {"role": "system", "content": "System prompt"},
            {"role": "user", "content": "User message"},
        ]

        request = optimizer.build_request_with_cache(messages, "cache-123")

        assert "cached_content" in request
        assert request["cached_content"] == "cache-123"
        assert "contents" in request

    def test_export_import_registry(self, optimizer):
        """Test exporting and importing cache registry."""
        optimizer.register_cache(
            cache_id="export-cache",
            content_hash="export123",
            token_count=50000,
            expires_at=datetime.now() + timedelta(hours=1),
        )

        exported = optimizer.export_cache_registry()
        assert len(exported) >= 1

        new_optimizer = GoogleCacheOptimizer()
        imported = new_optimizer.import_cache_registry(exported)
        assert imported >= 1

    def test_cached_content_info_serialization(self):
        """Test CachedContentInfo serialization."""
        info = CachedContentInfo(
            cache_id="test",
            content_hash="hash",
            created_at=datetime.now(),
            expires_at=datetime.now() + timedelta(hours=1),
            token_count=50000,
        )

        data = info.to_dict()
        restored = CachedContentInfo.from_dict(data)

        assert restored.cache_id == info.cache_id
        assert restored.content_hash == info.content_hash
        assert restored.token_count == info.token_count