dycw-utilities 0.113.2__tar.gz → 0.113.4__tar.gz

{dycw_utilities-0.113.2 → dycw_utilities-0.113.4}/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.4
 Name: dycw-utilities
-Version: 0.113.2
+Version: 0.113.4
 Author-email: Derek Wan <d.wan@icloud.com>
 License-File: LICENSE
 Requires-Python: >=3.12
 Requires-Dist: typing-extensions<4.14,>=4.13.1
 Provides-Extra: test
-Requires-Dist: hypothesis<6.132,>=6.131.10; extra == 'test'
+Requires-Dist: hypothesis<6.132,>=6.131.15; extra == 'test'
 Requires-Dist: pytest-asyncio<0.27,>=0.26.0; extra == 'test'
 Requires-Dist: pytest-cov<6.2,>=6.1.1; extra == 'test'
 Requires-Dist: pytest-instafail<0.6,>=0.5.0; extra == 'test'
@@ -14,7 +14,7 @@ Requires-Dist: pytest-lazy-fixtures<1.2,>=1.1.2; extra == 'test'
 Requires-Dist: pytest-only<2.2,>=2.1.2; extra == 'test'
 Requires-Dist: pytest-randomly<3.17,>=3.16.0; extra == 'test'
 Requires-Dist: pytest-regressions<2.8,>=2.7.0; extra == 'test'
-Requires-Dist: pytest-rerunfailures<16,>=15.0; extra == 'test'
+Requires-Dist: pytest-rerunfailures<16,>=15.1; extra == 'test'
 Requires-Dist: pytest-rng<1.1,>=1.0.0; extra == 'test'
 Requires-Dist: pytest-timeout<2.5,>=2.4.0; extra == 'test'
 Requires-Dist: pytest-xdist<3.7,>=3.6.1; extra == 'test'
@@ -37,7 +37,7 @@ Requires-Dist: atools<0.15,>=0.14.2; extra == 'zzz-test-atools'
 Provides-Extra: zzz-test-cachetools
 Requires-Dist: cachetools<5.6,>=5.5.2; extra == 'zzz-test-cachetools'
 Provides-Extra: zzz-test-click
-Requires-Dist: click<8.2,>=8.1.8; extra == 'zzz-test-click'
+Requires-Dist: click<8.3,>=8.2.0; extra == 'zzz-test-click'
 Requires-Dist: sqlalchemy<2.1,>=2.0.40; extra == 'zzz-test-click'
 Requires-Dist: whenever<0.8,>=0.7.3; extra == 'zzz-test-click'
 Provides-Extra: zzz-test-contextlib
@@ -80,7 +80,7 @@ Provides-Extra: zzz-test-hypothesis
 Requires-Dist: aiosqlite<0.22,>=0.21.0; extra == 'zzz-test-hypothesis'
 Requires-Dist: asyncpg<0.31,>=0.30.0; extra == 'zzz-test-hypothesis'
 Requires-Dist: greenlet<3.3,>=3.2.0; extra == 'zzz-test-hypothesis'
-Requires-Dist: hypothesis<6.132,>=6.131.10; extra == 'zzz-test-hypothesis'
+Requires-Dist: hypothesis<6.132,>=6.131.15; extra == 'zzz-test-hypothesis'
 Requires-Dist: luigi<3.7,>=3.6.0; extra == 'zzz-test-hypothesis'
 Requires-Dist: numpy<2.3,>=2.2.5; extra == 'zzz-test-hypothesis'
 Requires-Dist: pathvalidate<3.3,>=3.2.3; extra == 'zzz-test-hypothesis'
@@ -101,7 +101,7 @@ Requires-Dist: polars-lts-cpu<1.30,>=1.29.0; extra == 'zzz-test-jupyter'
 Provides-Extra: zzz-test-logging
 Requires-Dist: atomicwrites<1.5,>=1.4.1; extra == 'zzz-test-logging'
 Requires-Dist: coloredlogs<15.1,>=15.0.1; extra == 'zzz-test-logging'
-Requires-Dist: concurrent-log-handler<0.10,>=0.9.25; extra == 'zzz-test-logging'
+Requires-Dist: concurrent-log-handler<0.10,>=0.9.26; extra == 'zzz-test-logging'
 Requires-Dist: rich<14.1,>=14.0.0; extra == 'zzz-test-logging'
 Requires-Dist: tomlkit<0.14,>=0.13.2; extra == 'zzz-test-logging'
 Requires-Dist: tzlocal<5.4,>=5.3.1; extra == 'zzz-test-logging'
@@ -172,7 +172,7 @@ Requires-Dist: whenever<0.8,>=0.7.3; extra == 'zzz-test-redis'
 Provides-Extra: zzz-test-rich
 Requires-Dist: rich<14.1,>=14.0.0; extra == 'zzz-test-rich'
 Provides-Extra: zzz-test-scipy
-Requires-Dist: scipy<1.16,>=1.15.2; extra == 'zzz-test-scipy'
+Requires-Dist: scipy<1.16,>=1.15.3; extra == 'zzz-test-scipy'
 Provides-Extra: zzz-test-sentinel
 Provides-Extra: zzz-test-shelve
 Provides-Extra: zzz-test-slack-sdk

{dycw_utilities-0.113.2 → dycw_utilities-0.113.4}/pyproject.toml

@@ -16,9 +16,9 @@ dev = [
   "atomicwrites >= 1.4.1, < 1.5",
   "atools >= 0.14.2, < 0.15",
   "cachetools >= 5.5.2, < 5.6",
-  "click >= 8.1.8, < 8.2",
+  "click >= 8.2.0, < 8.3",
   "coloredlogs >= 15.0.1, < 15.1",
-  "concurrent-log-handler >= 0.9.25, < 0.10",
+  "concurrent-log-handler >= 0.9.26, < 0.10",
   "cryptography >= 44.0.2, < 44.1",
   "cvxpy >= 1.6.5, < 1.7",
   "eventkit >= 1.0.3, < 1.1",
@@ -26,7 +26,7 @@ dev = [
   "fpdf2 >= 2.8.3, < 2.9",
   "greenlet >= 3.2.0, < 3.3",  # for sqlalchemy async
   "httpx >= 0.28.1, < 0.29",  # for fastapi
-  "hypothesis >= 6.131.10, < 6.132",
+  "hypothesis >= 6.131.15, < 6.132",
   "img2pdf >= 0.6.0, < 0.7",
   "lightweight-charts >= 2.1, < 2.2",
   "loguru >= 0.7.3, < 0.8",
@@ -52,7 +52,7 @@ dev = [
   "redis >= 6.0.0, < 6.1",
   "rich >= 14.0.0, < 14.1",
   "scikit-learn >= 1.6.1, < 1.7",
-  "scipy >= 1.15.2, < 1.16",
+  "scipy >= 1.15.3, < 1.16",
   "slack-sdk >= 3.35.0, < 3.36",
   "sqlalchemy >= 2.0.40, < 2.1",
   "statsmodels >= 0.14.4, < 0.15",
@@ -74,7 +74,7 @@ dev = [
   "pytest-lazy-fixtures >= 1.1.2, < 1.2",
   "pytest-only >= 2.1.2, < 2.2",
   "pytest-randomly >= 3.16.0, < 3.17",
-  "pytest-rerunfailures >= 15.0, < 16",
+  "pytest-rerunfailures >= 15.1, < 16",
   "pytest-rng >= 1.0.0, < 1.1",
   "pytest-timeout >= 2.4.0, < 2.5",
   "pytest-xdist >= 3.6.1, < 3.7",
@@ -92,11 +92,11 @@ dependencies = [
 name = "dycw-utilities"
 readme = "README.md"
 requires-python = ">= 3.12"
-version = "0.113.2"
+version = "0.113.4"
 
 [project.optional-dependencies]
 test = [
-  "hypothesis >= 6.131.10, < 6.132",
+  "hypothesis >= 6.131.15, < 6.132",
   "pytest >= 8.3.5, < 8.4",
   "pytest-asyncio >= 0.26.0, < 0.27",
   "pytest-cov >= 6.1.1, < 6.2",
@@ -105,7 +105,7 @@ test = [
   "pytest-only >= 2.1.2, < 2.2",
   "pytest-randomly >= 3.16.0, < 3.17",
   "pytest-regressions >= 2.7.0, < 2.8",
-  "pytest-rerunfailures >= 15.0, < 16",
+  "pytest-rerunfailures >= 15.1, < 16",
   "pytest-rng >= 1.0.0, < 1.1",
   "pytest-timeout >= 2.4.0, < 2.5",
   "pytest-xdist >= 3.6.1, < 3.7",
@@ -127,7 +127,7 @@ zzz-test-atools = [
 ]
 zzz-test-cachetools = ["cachetools >= 5.5.2, < 5.6"]
 zzz-test-click = [
-  "click >= 8.1.8, < 8.2",
+  "click >= 8.2.0, < 8.3",
   "sqlalchemy >= 2.0.40, < 2.1",
   "whenever >= 0.7.3, < 0.8",
 ]
@@ -174,7 +174,7 @@ zzz-test-hypothesis = [
   "aiosqlite >= 0.21.0, < 0.22",
   "asyncpg >= 0.30.0, < 0.31",  # for sqlalchemy async
   "greenlet >= 3.2.0, < 3.3",  # for sqlalchemy async
-  "hypothesis >= 6.131.10, < 6.132",
+  "hypothesis >= 6.131.15, < 6.132",
   "luigi >= 3.6.0, < 3.7",
   "numpy >= 2.2.5, < 2.3",
   "pathvalidate >= 3.2.3, < 3.3",
@@ -197,7 +197,7 @@ zzz-test-jupyter = [
 zzz-test-logging = [
   "atomicwrites >= 1.4.1, < 1.5",
   "coloredlogs >= 15.0.1, < 15.1",
-  "concurrent-log-handler >= 0.9.25, < 0.10",
+  "concurrent-log-handler >= 0.9.26, < 0.10",
   "rich >= 14.0.0, < 14.1",
   "tomlkit >= 0.13.2, < 0.14",
   "tzlocal >= 5.3.1, < 5.4",
@@ -266,7 +266,7 @@ zzz-test-redis = [
   "whenever >= 0.7.3, < 0.8",
 ]
 zzz-test-rich = ["rich >= 14.0.0, < 14.1"]
-zzz-test-scipy = ["scipy >= 1.15.2, < 1.16"]
+zzz-test-scipy = ["scipy >= 1.15.3, < 1.16"]
 zzz-test-sentinel = []
 zzz-test-shelve = []
 zzz-test-slack-sdk = [
@@ -334,7 +334,7 @@ zzz-test-zoneinfo = [
 # bump-my-version
 [tool.bumpversion]
 allow_dirty = true
-current_version = "0.113.2"
+current_version = "0.113.4"
 
 [[tool.bumpversion.files]]
 filename = "src/utilities/__init__.py"

{dycw_utilities-0.113.2 → dycw_utilities-0.113.4}/src/tests/test_click.py

@@ -102,12 +102,12 @@ class TestFileAndDirPaths:
         file_path.touch()
         result = CliRunner().invoke(cli, [str(file_path)])
         assert result.exit_code == 2
-        assert search("is a file", result.stdout)
+        assert search("is a file", result.stderr)
 
         non_existent = tmp_path.joinpath("non-existent")
         result = CliRunner().invoke(cli, [str(non_existent)])
         assert result.exit_code == 2
-        assert search("does not exist", result.stdout)
+        assert search("does not exist", result.stderr)
 
     def test_existing_file_path(self, *, tmp_path: Path) -> None:
         @command()
@@ -119,7 +119,7 @@ class TestFileAndDirPaths:
 
         result = CliRunner().invoke(cli, [str(tmp_path)])
         assert result.exit_code == 2
-        assert search("is a directory", result.stdout)
+        assert search("is a directory", result.stderr)
 
         file_path = tmp_path.joinpath("file.txt")
         file_path.touch()
@@ -129,7 +129,7 @@ class TestFileAndDirPaths:
         non_existent = tmp_path.joinpath("non-existent")
         result = CliRunner().invoke(cli, [str(non_existent)])
         assert result.exit_code == 2
-        assert search("does not exist", result.stdout)
+        assert search("does not exist", result.stderr)
 
     def test_dir_path(self, *, tmp_path: Path) -> None:
         @command()
@@ -146,7 +146,7 @@ class TestFileAndDirPaths:
         file_path.touch()
         result = CliRunner().invoke(cli, [str(file_path)])
         assert result.exit_code == 2
-        assert search("is a file", result.stdout)
+        assert search("is a file", result.stderr)
 
         non_existent = tmp_path.joinpath("non-existent")
         result = CliRunner().invoke(cli, [str(non_existent)])
@@ -162,7 +162,7 @@ class TestFileAndDirPaths:
 
         result = CliRunner().invoke(cli, [str(tmp_path)])
         assert result.exit_code == 2
-        assert search("is a directory", result.stdout)
+        assert search("is a directory", result.stderr)
 
         file_path = tmp_path.joinpath("file.txt")
         file_path.touch()
@@ -394,7 +394,7 @@ class TestParameters:
         assert result.exit_code == 2
         assert search(
             "Invalid value for '--value': Object '0' of type 'int' must be a string",
-            result.stdout,
+            result.stderr,
         )
 
 

{dycw_utilities-0.113.2 → dycw_utilities-0.113.4}/src/tests/test_datetime.py

@@ -50,6 +50,7 @@ from utilities.datetime import (
     AreEqualDateTimesError,
     CheckDateNotDateTimeError,
     EnsureMonthError,
+    GetMinMaxDateError,
     MeanDateTimeError,
     MeanTimeDeltaError,
     MillisecondsSinceEpochError,
@@ -67,6 +68,11 @@ from utilities.datetime import (
     _DateDurationToIntTimeDeltaError,
     _DateDurationToTimeDeltaFloatError,
     _DateDurationToTimeDeltaTimeDeltaError,
+    _GetMinMaxDateMaxAgeError,
+    _GetMinMaxDateMaxDateError,
+    _GetMinMaxDateMinAgeError,
+    _GetMinMaxDateMinDateError,
+    _GetMinMaxDatePeriodError,
     _ParseTwoDigitYearInvalidIntegerError,
     _ParseTwoDigitYearInvalidStringError,
     add_duration,
@@ -91,6 +97,7 @@ from utilities.datetime import (
     get_date,
     get_datetime,
     get_half_years,
+    get_min_max_date,
     get_months,
     get_now,
     get_quarters,
@@ -129,6 +136,7 @@ from utilities.datetime import (
 from utilities.functions import not_func
 from utilities.hypothesis import (
     assume_does_not_raise,
+    date_durations,
     int32s,
     months,
     pairs,
@@ -148,6 +156,7 @@ if TYPE_CHECKING:
     from utilities.sentinel import Sentinel
     from utilities.types import (
         DateOrDateTime,
+        Duration,
         MaybeCallableDate,
         MaybeCallableDateTime,
         Number,
@@ -675,6 +684,79 @@ class TestGetDateTime:
         assert get_datetime(datetime=lambda: datetime) == datetime
 
 
+class TestGetMinMaxDate:
+    @given(
+        min_date=dates(max_value=TODAY_UTC) | none(),
+        max_date=dates(max_value=TODAY_UTC) | none(),
+        min_age=date_durations(min_int=0, min_timedelta=ZERO_TIME) | none(),
+        max_age=date_durations(min_int=0, min_timedelta=ZERO_TIME) | none(),
+    )
+    def test_main(
+        self,
+        *,
+        min_date: dt.date | None,
+        max_date: dt.date | None,
+        min_age: Duration | None,
+        max_age: Duration | None,
+    ) -> None:
+        with assume_does_not_raise(GetMinMaxDateError, OverflowError):
+            min_date_use, max_date_use = get_min_max_date(
+                min_date=min_date, max_date=max_date, min_age=min_age, max_age=max_age
+            )
+        if (min_date is None) and (max_age is None):
+            assert min_date_use is None
+        else:
+            assert min_date_use is not None
+        if (max_date is None) and (min_age is None):
+            assert max_date_use is None
+        else:
+            assert max_date_use is not None
+        if min_date_use is not None:
+            assert min_date_use <= get_today()
+        if max_date_use is not None:
+            assert max_date_use <= get_today()
+        if (min_date_use is not None) and (max_date_use is not None):
+            assert min_date_use <= max_date_use
+
+    @given(date=dates(min_value=TODAY_UTC + DAY))
+    def test_error_min_date(self, *, date: dt.date) -> None:
+        with raises(
+            _GetMinMaxDateMinDateError,
+            match="Min date must be at most today; got .* > .*",
+        ):
+            _ = get_min_max_date(min_date=date)
+
+    @given(duration=date_durations(max_int=-1, max_timedelta=-DAY))
+    def test_error_min_age(self, *, duration: Duration) -> None:
+        with raises(
+            _GetMinMaxDateMinAgeError, match="Min age must be non-negative; got .*"
+        ):
+            _ = get_min_max_date(min_age=duration)
+
+    @given(date=dates(min_value=TODAY_UTC + DAY))
+    def test_error_max_date(self, *, date: dt.date) -> None:
+        with raises(
+            _GetMinMaxDateMaxDateError,
+            match="Max date must be at most today; got .* > .*",
+        ):
+            _ = get_min_max_date(max_date=date)
+
+    @given(duration=date_durations(max_int=-1, max_timedelta=-DAY))
+    def test_error_max_age(self, *, duration: Duration) -> None:
+        with raises(
+            _GetMinMaxDateMaxAgeError, match="Max age must be non-negative; got .*"
+        ):
+            _ = get_min_max_date(max_age=duration)
+
+    @given(dates=pairs(dates(max_value=TODAY_UTC), unique=True, sorted=True))
+    def test_error_period(self, *, dates: tuple[dt.date, dt.date]) -> None:
+        with raises(
+            _GetMinMaxDatePeriodError,
+            match="Min date must be at most max date; got .* > .*",
+        ):
+            _ = get_min_max_date(min_date=dates[1], max_date=dates[0])
+
+
 class TestGetNow:
     @given(time_zone=timezones())
     def test_function(self, *, time_zone: ZoneInfo) -> None:

{dycw_utilities-0.113.2 → dycw_utilities-0.113.4}/src/utilities/__init__.py

@@ -1,3 +1,3 @@
 from __future__ import annotations
 
-__version__ = "0.113.2"
+__version__ = "0.113.4"

{dycw_utilities-0.113.2 → dycw_utilities-0.113.4}/src/utilities/click.py

@@ -125,7 +125,8 @@ class Enum(ParamType, Generic[TEnum]):
             self.fail(str(error), param, ctx)
 
     @override
-    def get_metavar(self, param: Parameter) -> str | None:
+    def get_metavar(self, param: Parameter, ctx: Context) -> str | None:
+        _ = ctx
         desc = ",".join(e.name for e in self._enum)
         return _make_metavar(param, desc)
 
@@ -273,8 +274,8 @@ class FrozenSetParameter(ParamType, Generic[_TParam, _T]):
         return frozenset(self._param.convert(v, param, ctx) for v in values)
 
     @override
-    def get_metavar(self, param: Parameter) -> str | None:
-        if (metavar := self._param.get_metavar(param)) is None:
+    def get_metavar(self, param: Parameter, ctx: Context) -> str | None:
+        if (metavar := self._param.get_metavar(param, ctx)) is None:
             name = self.name.upper()
         else:
             name = f"FROZENSET{metavar}"
@@ -397,8 +398,8 @@ class ListParameter(ParamType, Generic[_TParam, _T]):
         return [self._param.convert(v, param, ctx) for v in values]
 
     @override
-    def get_metavar(self, param: Parameter) -> str | None:
-        if (metavar := self._param.get_metavar(param)) is None:
+    def get_metavar(self, param: Parameter, ctx: Context) -> str | None:
+        if (metavar := self._param.get_metavar(param, ctx)) is None:
             name = self.name.upper()
         else:
             name = f"LIST{metavar}"

{dycw_utilities-0.113.2 → dycw_utilities-0.113.4}/src/utilities/datetime.py

@@ -1,7 +1,7 @@
 from __future__ import annotations
 
 import datetime as dt
-from collections.abc import Callable, Iterable
+from collections.abc import Callable, Iterable, Sequence
 from dataclasses import dataclass, replace
 from re import search, sub
 from statistics import fmean
@@ -495,6 +495,101 @@ def get_half_years(*, n: int = 1) -> dt.timedelta:
 
 HALF_YEAR = get_half_years(n=1)
 
+##
+
+
+def get_min_max_date(
+    *,
+    min_date: dt.date | None = None,
+    max_date: dt.date | None = None,
+    min_age: Duration | None = None,
+    max_age: Duration | None = None,
+    time_zone: TimeZoneLike = UTC,
+) -> tuple[dt.date | None, dt.date | None]:
+    """Get the min/max date given a combination of dates/ages."""
+    today = get_today(time_zone=time_zone)
+    min_parts: Sequence[dt.date] = []
+    if min_date is not None:
+        if min_date > today:
+            raise _GetMinMaxDateMinDateError(min_date=min_date, today=today)
+        min_parts.append(min_date)
+    if max_age is not None:
+        if date_duration_to_timedelta(max_age) < ZERO_TIME:
+            raise _GetMinMaxDateMaxAgeError(max_age=max_age)
+        min_parts.append(sub_duration(today, duration=max_age))
+    min_date_use = max(min_parts, default=None)
+    max_parts: Sequence[dt.date] = []
+    if max_date is not None:
+        if max_date > today:
+            raise _GetMinMaxDateMaxDateError(max_date=max_date, today=today)
+        max_parts.append(max_date)
+    if min_age is not None:
+        if date_duration_to_timedelta(min_age) < ZERO_TIME:
+            raise _GetMinMaxDateMinAgeError(min_age=min_age)
+        max_parts.append(sub_duration(today, duration=min_age))
+    max_date_use = min(max_parts, default=None)
+    if (
+        (min_date_use is not None)
+        and (max_date_use is not None)
+        and (min_date_use > max_date_use)
+    ):
+        raise _GetMinMaxDatePeriodError(min_date=min_date_use, max_date=max_date_use)
+    return min_date_use, max_date_use
+
+
+@dataclass(kw_only=True, slots=True)
+class GetMinMaxDateError(Exception): ...
+
+
+@dataclass(kw_only=True, slots=True)
+class _GetMinMaxDateMinDateError(GetMinMaxDateError):
+    min_date: dt.date
+    today: dt.date
+
+    @override
+    def __str__(self) -> str:
+        return f"Min date must be at most today; got {self.min_date} > {self.today}"
+
+
+@dataclass(kw_only=True, slots=True)
+class _GetMinMaxDateMinAgeError(GetMinMaxDateError):
+    min_age: Duration
+
+    @override
+    def __str__(self) -> str:
+        return f"Min age must be non-negative; got {self.min_age}"
+
+
+@dataclass(kw_only=True, slots=True)
+class _GetMinMaxDateMaxDateError(GetMinMaxDateError):
+    max_date: dt.date
+    today: dt.date
+
+    @override
+    def __str__(self) -> str:
+        return f"Max date must be at most today; got {self.max_date} > {self.today}"
+
+
+@dataclass(kw_only=True, slots=True)
+class _GetMinMaxDateMaxAgeError(GetMinMaxDateError):
+    max_age: Duration
+
+    @override
+    def __str__(self) -> str:
+        return f"Max age must be non-negative; got {self.max_age}"
+
+
+@dataclass(kw_only=True, slots=True)
+class _GetMinMaxDatePeriodError(GetMinMaxDateError):
+    min_date: dt.date
+    max_date: dt.date
+
+    @override
+    def __str__(self) -> str:
+        return (
+            f"Min date must be at most max date; got {self.min_date} > {self.max_date}"
+        )
+
 
 ##
 
@@ -1244,6 +1339,7 @@ __all__ = [
     "CheckDateNotDateTimeError",
     "DateOrMonth",
     "EnsureMonthError",
+    "GetMinMaxDateError",
     "MeanDateTimeError",
     "MeanTimeDeltaError",
     "MillisecondsSinceEpochError",
@@ -1280,6 +1376,7 @@ __all__ = [
     "get_date",
     "get_datetime",
     "get_half_years",
+    "get_min_max_date",
     "get_months",
     "get_now",
     "get_quarters",

{dycw_utilities-0.113.2 → dycw_utilities-0.113.4}/src/utilities/redis.py

@@ -607,7 +607,7 @@ class Publisher(QueueProcessor[tuple[str, EncodableT]]):
 
 
 _SUBSCRIBE_TIMEOUT: Duration = SECOND
-_SUBSCRIBE_SLEEP: Duration = 10 * MILLISECOND
+_SUBSCRIBE_SLEEP: Duration = MILLISECOND
 
 
 @overload
@@ -617,8 +617,8 @@ def subscribe(
     /,
     *,
     deserializer: Callable[[bytes], _T],
-    timeout: Duration | None = ...,
-    sleep: Duration = ...,
+    timeout: Duration | None = _SUBSCRIBE_TIMEOUT,
+    sleep: Duration = _SUBSCRIBE_SLEEP,
 ) -> AsyncIterator[_T]: ...
 @overload
 def subscribe(
@@ -627,8 +627,8 @@ def subscribe(
     /,
     *,
     deserializer: None = None,
-    timeout: Duration | None = ...,
-    sleep: Duration = ...,
+    timeout: Duration | None = _SUBSCRIBE_TIMEOUT,
+    sleep: Duration = _SUBSCRIBE_SLEEP,
 ) -> AsyncIterator[bytes]: ...
 async def subscribe(
     pubsub: PubSub,