Update dateparser stubs for 1.1 (#7368)

stubs/dateparser/METADATA.toml

@@ -1 +1 @@
-version = "1.0.*"
+version = "1.1.*"

stubs/dateparser/dateparser/__init__.pyi

@@ -1,12 +1,7 @@
 import datetime
-import sys
+from typing_extensions import Literal, TypedDict
 
-from dateparser.date import DateDataParser
-
-if sys.version_info >= (3, 8):
-    from typing import Literal, TypedDict
-else:
-    from typing_extensions import Literal, TypedDict
+from .date import DateDataParser, _DetectLanguagesFunction
 
 __version__: str
 
@@ -38,4 +33,5 @@ def parse(
     locales: list[str] | tuple[str, ...] | set[str] | None = ...,
     region: str | None = ...,
     settings: _Settings | None = ...,
+    detect_languages_function: _DetectLanguagesFunction | None = ...,
 ) -> datetime.datetime | None: ...

stubs/dateparser/dateparser/date.pyi

@@ -1,22 +1,18 @@
 import collections
-import sys
 from _typeshed import Self as Self
+from collections.abc import Callable, Iterable, Iterator
 from datetime import datetime
-from typing import ClassVar, Iterable, Iterator, overload
+from typing import ClassVar, Pattern, overload
+from typing_extensions import Literal
 
 from dateparser import _Settings
 from dateparser.conf import Settings
 from dateparser.languages.loader import LocaleDataLoader
 from dateparser.languages.locale import Locale
 
-if sys.version_info >= (3, 8):
-    from re import Pattern
-    from typing import Literal
-else:
-    from typing import Pattern
-    from typing_extensions import Literal
-
+_DetectLanguagesFunction = Callable[[str, float], list[str]]
 _Period = Literal["time", "day", "week", "month", "year"]
+
 APOSTROPHE_LOOK_ALIKE_CHARS: list[str]
 RE_NBSP: Pattern[str]
 RE_SPACES: Pattern[str]
@@ -92,6 +88,7 @@ class DateDataParser:
     languages: list[str] | None
     locales: list[str] | tuple[str, ...] | set[str] | None
     region: str
+    detect_languages_function: _DetectLanguagesFunction | None
     previous_locales: collections.OrderedDict[Locale, None]
     def __init__(
         self,
@@ -101,6 +98,7 @@ class DateDataParser:
         try_previous_locales: bool = ...,
         use_given_order: bool = ...,
         settings: _Settings | None = ...,
+        detect_languages_function: _DetectLanguagesFunction | None = ...,
     ) -> None: ...
     def get_date_data(self, date_string: str, date_formats: list[str] | tuple[str, ...] | set[str] | None = ...) -> DateData: ...
     def get_date_tuple(self, date_string: str, date_formats: list[str] | tuple[str, ...] | set[str] | None = ...): ...

stubs/dateparser/dateparser/search/__init__.pyi

@@ -1,12 +1,9 @@
-import sys
 from collections.abc import Mapping, Set as AbstractSet
 from datetime import datetime
 from typing import Any, overload
+from typing_extensions import Literal
 
-if sys.version_info >= (3, 8):
-    from typing import Literal
-else:
-    from typing_extensions import Literal
+from ..date import _DetectLanguagesFunction
 
 @overload
 def search_dates(
@@ -14,6 +11,7 @@ def search_dates(
     languages: list[str] | tuple[str, ...] | AbstractSet[str] | None,
     settings: Mapping[Any, Any] | None,
     add_detected_language: Literal[True],
+    detect_languages_function: _DetectLanguagesFunction | None = ...,
 ) -> list[tuple[str, datetime, str]]: ...
 @overload
 def search_dates(
@@ -21,4 +19,5 @@ def search_dates(
     languages: list[str] | tuple[str, ...] | AbstractSet[str] | None = ...,
     settings: Mapping[Any, Any] | None = ...,
     add_detected_language: Literal[False] = ...,
+    detect_languages_function: _DetectLanguagesFunction | None = ...,
 ) -> list[tuple[str, datetime]]: ...

stubs/dateparser/dateparser/search/search.pyi

@@ -1,5 +1,7 @@
 from typing import Any
 
+from ..date import _DetectLanguagesFunction
+
 RELATIVE_REG: Any
 
 def date_is_relative(translation): ...
@@ -25,5 +27,13 @@ class DateSearchWithDetection:
     search: Any
     def __init__(self) -> None: ...
     language_detector: Any
-    def detect_language(self, text, languages): ...
-    def search_dates(self, text, languages: Any | None = ..., settings: Any | None = ...): ...
+    def detect_language(
+        self, text, languages, settings: Any | None = ..., detect_languages_function: _DetectLanguagesFunction | None = ...
+    ): ...
+    def search_dates(
+        self,
+        text,
+        languages: Any | None = ...,
+        settings: Any | None = ...,
+        detect_languages_function: _DetectLanguagesFunction | None = ...,
+    ): ...