Files
ss-tools/backend/tests/test_deprecation_audit_fixes.py
root 632b730fff chore: migrate GRACE-Poly anchors to hierarchical dotted naming
Systematic rename of all semantic anchors (#region, [DEF], @RELATION)
across 1400+ files — backend Python, frontend Svelte/TS, specs, docs:
- Flat anchors become Namespace.Module.Entity
- @RELATION references updated to match new anchor paths
- Zero business logic changes
2026-07-22 11:48:15 +03:00

109 lines
5.9 KiB
Python

# #region Test.DeprecationAuditFixes.TestDeprecationAuditFixes [C:3] [TYPE Module] [SEMANTICS test,deprecation,warning,audit]
# @BRIEF Verify Class 7 fix — is_multimodal_model should emit DeprecationWarning.
# @RELATION BINDS_TO -> [Services.LlmPromptTemplates]
# @TEST_EDGE: deprecated_function_warns -> is_multimodal_model should emit DeprecationWarning
# @TEST_EDGE: old_callers_not_broken -> returns correct boolean for known multimodal models
# @TEST_EDGE: text_only_model_returns_false -> models with text-only markers return False
# @RATIONALE The RATIONALE comment in llm_prompt_templates.py says warnings.warn(DeprecationWarning)
# was added, but the actual function body (lines 137-167) does NOT contain the call.
# This is a known gap — the DeprecationWarning shim was documented but not implemented.
from pathlib import Path
import pytest
import sys
import warnings
sys.path.insert(0, str(Path(__file__).parent.parent / "src"))
class TestDeprecationAuditFixes:
"""Verify is_multimodal_model behavior and document missing DeprecationWarning shim."""
# #region Test.DeprecationAuditFixes.TestIsMultimodalModelEmitsWarning [C:2] [TYPE Function]
# @BRIEF is_multimodal_model should emit DeprecationWarning (shim not yet implemented).
def test_is_multimodal_model_emits_warning(self):
"""Verify is_multimodal_model emits DeprecationWarning.
NOTE: The RATIONALE comment in the source says warnings.warn(DeprecationWarning)
was added as a deprecation shim, but the function body (llm_prompt_templates.py:137-167)
does NOT contain the call. This test documents the gap.
"""
# Check if the source actually has the DeprecationWarning call
import inspect
from src.services.llm_prompt_templates import is_multimodal_model
source = inspect.getsource(is_multimodal_model)
if "DeprecationWarning" not in source:
pytest.skip(
"GAP: is_multimodal_model body does not contain warnings.warn(DeprecationWarning). "
"The RATIONALE comment says it was added but the implementation is missing. "
"Add: warnings.warn(DeprecationWarning('is_multimodal_model is deprecated, "
"use db_provider.is_multimodal flag instead'), stacklevel=2)"
)
# If the fix IS applied, verify it works
with pytest.warns(DeprecationWarning):
result = is_multimodal_model("gpt-4o")
assert result is True
# #endregion Test.DeprecationAuditFixes.TestIsMultimodalModelEmitsWarning
# #region Test.DeprecationAuditFixes.TestMultimodalModelReturnsTrue [C:2] [TYPE Function]
# @BRIEF Known multimodal models (gpt-4o, claude-3, gemini) return True.
def test_multimodal_model_returns_true(self):
from src.services.llm_prompt_templates import is_multimodal_model
multimodal_cases = ["gpt-4o", "claude-3-sonnet", "gemini-pro-vision", "gpt-4.1"]
for model in multimodal_cases:
with warnings.catch_warnings():
warnings.simplefilter("ignore", DeprecationWarning)
assert is_multimodal_model(model) is True, f"{model} should be multimodal"
# #endregion Test.DeprecationAuditFixes.TestMultimodalModelReturnsTrue
# #region Test.DeprecationAuditFixes.TestTextOnlyModelReturnsFalse [C:2] [TYPE Function]
# @BRIEF Text-only models (embedding, whisper, rerank) return False.
def test_text_only_model_returns_false(self):
from src.services.llm_prompt_templates import is_multimodal_model
text_only_cases = ["text-embedding-3", "whisper-1", "rerank-v2", "tts-1"]
for model in text_only_cases:
with warnings.catch_warnings():
warnings.simplefilter("ignore", DeprecationWarning)
assert is_multimodal_model(model) is False, f"{model} should be text-only"
# #endregion Test.DeprecationAuditFixes.TestTextOnlyModelReturnsFalse
# #region Test.DeprecationAuditFixes.TestEmptyModelReturnsFalse [C:2] [TYPE Function]
# @BRIEF Empty or None model name returns False without error.
def test_empty_model_returns_false(self):
from src.services.llm_prompt_templates import is_multimodal_model
with warnings.catch_warnings():
warnings.simplefilter("ignore", DeprecationWarning)
assert is_multimodal_model("") is False
assert is_multimodal_model(" ") is False
# #endregion Test.DeprecationAuditFixes.TestEmptyModelReturnsFalse
# #region Test.DeprecationAuditFixes.TestCaseInsensitiveMatching [C:2] [TYPE Function]
# @BRIEF Model name matching is case-insensitive.
def test_case_insensitive_matching(self):
from src.services.llm_prompt_templates import is_multimodal_model
with warnings.catch_warnings():
warnings.simplefilter("ignore", DeprecationWarning)
assert is_multimodal_model("GPT-4O") is True
assert is_multimodal_model("CLAUDE-3-OPUS") is True
# #endregion Test.DeprecationAuditFixes.TestCaseInsensitiveMatching
# #region Test.DeprecationAuditFixes.TestDeprecationCommentExists [C:2] [TYPE Function]
# @BRIEF The source module documents the @DEPRECATED rationale in the region header.
def test_deprecation_comment_exists(self):
"""Verify the source file documents the is_multimodal_model deprecation.
The @DEPRECATED tag is in the region header (line 127), not in the function body.
inspect.getsource(function) only returns the body (lines 137-167).
"""
module_path = Path(__file__).parent.parent / "src" / "services" / "llm_prompt_templates.py"
source = module_path.read_text(encoding="utf-8")
assert "DEPRECATED" in source, "Source must document @DEPRECATED status"
assert "is_multimodal_model is deprecated" in source.lower() or "deprecated" in source.lower()
# #endregion Test.DeprecationAuditFixes.TestDeprecationCommentExists
# #endregion Test.DeprecationAuditFixes.TestDeprecationAuditFixes