[refactor] engine processors: add type for time range and safesearch in OnlineParams

searx/engines/kagi.py

@@ -47,6 +47,7 @@ from datetime import datetime, timedelta
 import typing as t
 
 
+from searx.search.processors.abstract import TimeRangeType
 from searx.extended_types import SXNG_Response
 from searx.result_types import EngineResults
 from searx.utils import html_to_text, parse_duration_string
@@ -54,7 +55,6 @@ from searx.utils import html_to_text, parse_duration_string
 if t.TYPE_CHECKING:
     from searx.search.processors import OnlineParams
 
-TimeRangeType = t.Literal["day", "week", "month", "year"]
 about = {
     "website": "https://kagi.com",
     "wikidata_id": "Q26000117",

searx/search/processors/abstract.py

@@ -29,6 +29,10 @@ logger = logger.getChild("searx.search.processor")
 SUSPENDED_STATUS: dict[int | str, "SuspendedStatus"] = {}
 
 
+TimeRangeType = t.Literal["day", "week", "month", "year"]
+SafesearchType = t.Literal[0, 1, 2]
+
+
 class RequestParams(t.TypedDict):
     """Basic quantity of the Request parameters of all engine types."""
 
@@ -51,10 +55,10 @@ class RequestParams(t.TypedDict):
     pageno: int
     """Current page number, where the first page is ``1``."""
 
-    safesearch: t.Literal[0, 1, 2]
+    safesearch: SafesearchType
     """Safe-Search filter (0:normal, 1:moderate, 2:strict)."""
 
-    time_range: t.Literal["day", "week", "month", "year"] | None
+    time_range: TimeRangeType | None
     """Time-range filter."""
 
     engine_data: dict[str, str]