Add tests for HistoryStr validation

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: gerwyn-ng

tests/test_coercions.py

@@ -1,11 +1,13 @@
-"""Tests for DateStr and SelectStr coercion types."""
+"""Tests for DateStr, SelectStr, and HistoryStr coercion types."""
 
 import datetime
 
-from pydantic import BaseModel
+import pytest
+from pydantic import BaseModel, ValidationError
 
-from ahrefs.types._coercions import DateStr, SelectStr
+from ahrefs.types._coercions import DateStr, HistoryStr, SelectStr
 from ahrefs.types._generated import (
+    SiteExplorerBestByExternalLinksRequest,
     SiteExplorerDomainRatingRequest,
     SiteExplorerOrganicKeywordsRequest,
 )
@@ -19,6 +21,10 @@ class _SelectModel(BaseModel):
     select: SelectStr
 
 
+class _HistoryModel(BaseModel):
+    history: HistoryStr
+
+
 class TestDateStr:
     def test_string_passthrough(self) -> None:
         m = _DateModel(date="2025-01-15")
@@ -39,6 +45,28 @@ def test_list_joined(self) -> None:
         assert m.select == "keyword,position"
 
 
+class TestHistoryStr:
+    def test_live(self) -> None:
+        m = _HistoryModel(history="live")
+        assert m.history == "live"
+
+    def test_all_time(self) -> None:
+        m = _HistoryModel(history="all_time")
+        assert m.history == "all_time"
+
+    def test_since_date(self) -> None:
+        m = _HistoryModel(history="since:2025-01-01")
+        assert m.history == "since:2025-01-01"
+
+    def test_invalid_value_rejected(self) -> None:
+        with pytest.raises(ValidationError, match="recent"):
+            _HistoryModel(history="recent")
+
+    def test_invalid_since_format_rejected(self) -> None:
+        with pytest.raises(ValidationError, match="Invalid history value"):
+            _HistoryModel(history="since:01-2025")
+
+
 class TestRequestModelRoundTrip:
     def test_date_with_date_object(self) -> None:
         req = SiteExplorerDomainRatingRequest(
@@ -69,3 +97,15 @@ def test_select_with_string(self) -> None:
         )
         data = req.model_dump(mode="json", exclude_none=True)
         assert data["select"] == "keyword,position"
+
+    def test_history_valid(self) -> None:
+        req = SiteExplorerBestByExternalLinksRequest(
+            target="x", select="url_to", history="live"
+        )
+        assert req.history == "live"
+
+    def test_history_invalid_rejected(self) -> None:
+        with pytest.raises(ValidationError, match="recent"):
+            SiteExplorerBestByExternalLinksRequest(
+                target="x", select="url_to", history="recent"
+            )