[dateparser] Annotate a few return and argument types (#15411)

Author: donbarbos

stubs/dateparser/dateparser/calendars/__init__.pyi

@@ -1,5 +1,5 @@
-from _typeshed import Incomplete
 from abc import abstractmethod
+from datetime import datetime
 from typing import ClassVar, Protocol, type_check_only
 
 from dateparser.conf import Settings
@@ -44,4 +44,4 @@ class non_gregorian_parser(_parser):
     @abstractmethod
     def handle_two_digit_year(self, year: int) -> int: ...
     @classmethod
-    def parse(cls, datestring: str, settings: Settings) -> tuple[Incomplete, str | None]: ...  # type: ignore[override]
+    def parse(cls, datestring: str, settings: Settings) -> tuple[datetime, str | None]: ...  # type: ignore[override]

stubs/dateparser/dateparser/freshness_date_parser.pyi

@@ -1,5 +1,6 @@
 import re
 from _typeshed import Incomplete
+from datetime import datetime
 from typing import Final
 from zoneinfo import ZoneInfo
 
@@ -10,7 +11,7 @@ PATTERN: Final[re.Pattern[str]]
 
 class FreshnessDateDataParser:
     def get_local_tz(self) -> ZoneInfo: ...
-    def parse(self, date_string: str, settings: Settings) -> tuple[Incomplete | None, str | None]: ...
+    def parse(self, date_string: str, settings: Settings) -> tuple[datetime | None, str | None]: ...
     def get_kwargs(
         self, date_string: str
     ) -> tuple[dict[str, float], dict[str, Incomplete]] | dict[None, None]: ...  # return empty dict if pattern not found

stubs/dateparser/dateparser/parser.pyi

@@ -54,7 +54,9 @@ class _parser:
     ordered_num_directives: OrderedDict[str, list[str]]
     def __init__(self, tokens: Iterable[Incomplete], settings: Settings) -> None: ...
     @classmethod
-    def parse(cls, datestring: str, settings: Settings, tz: datetime.tzinfo | None = None) -> tuple[Incomplete, str | None]: ...
+    def parse(
+        cls, datestring: str, settings: Settings, tz: datetime.tzinfo | None = None
+    ) -> tuple[datetime.datetime, str | None]: ...
 
 class tokenizer:
     digits: Literal["0123456789:"]

stubs/dateparser/dateparser/timezone_parser.pyi

@@ -8,9 +8,9 @@ _DateTimeT = TypeVar("_DateTimeT", bound=datetime)
 
 class StaticTzInfo(tzinfo):
     def __init__(self, name: str, offset: timedelta) -> None: ...
-    def tzname(self, dt) -> str: ...
-    def utcoffset(self, dt) -> timedelta: ...
-    def dst(self, dt) -> timedelta: ...
+    def tzname(self, dt: datetime | None) -> str: ...
+    def utcoffset(self, dt: datetime | None) -> timedelta: ...
+    def dst(self, dt: datetime | None) -> timedelta: ...
     def localize(self, dt: _DateTimeT, is_dst: bool = False) -> _DateTimeT: ...
     def __getinitargs__(self) -> tuple[str, timedelta]: ...