summaryrefslogtreecommitdiffstats
path: root/src/pendulum/utils/_zoneinfo.py
blob: e9f02514cb1a382347eeeeadd4684a4dc7f9926d (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
from __future__ import annotations

import sys

from typing import TYPE_CHECKING


if sys.version_info < (3, 9):
    # Works around https://github.com/pganssle/zoneinfo/issues/125
    from backports.zoneinfo import TZPATH
    from backports.zoneinfo import InvalidTZPathWarning
    from backports.zoneinfo import ZoneInfoNotFoundError
    from backports.zoneinfo import available_timezones
    from backports.zoneinfo import reset_tzpath

    if TYPE_CHECKING:
        from collections.abc import Iterable
        from datetime import datetime
        from datetime import timedelta
        from datetime import tzinfo
        from typing import Any
        from typing import Protocol

        from typing_extensions import Self

        class _IOBytes(Protocol):
            def read(self, __size: int) -> bytes:
                ...

            def seek(self, __size: int, __whence: int = ...) -> Any:
                ...

        class ZoneInfo(tzinfo):
            @property
            def key(self) -> str:
                ...

            def __init__(self, key: str) -> None:
                ...

            @classmethod
            def no_cache(cls, key: str) -> Self:
                ...

            @classmethod
            def from_file(cls, __fobj: _IOBytes, key: str | None = ...) -> Self:
                ...

            @classmethod
            def clear_cache(cls, *, only_keys: Iterable[str] | None = ...) -> None:
                ...

            def tzname(self, __dt: datetime | None) -> str | None:
                ...

            def utcoffset(self, __dt: datetime | None) -> timedelta | None:
                ...

            def dst(self, __dt: datetime | None) -> timedelta | None:
                ...

    else:
        from backports.zoneinfo import ZoneInfo

else:
    from zoneinfo import TZPATH
    from zoneinfo import InvalidTZPathWarning
    from zoneinfo import ZoneInfo
    from zoneinfo import ZoneInfoNotFoundError
    from zoneinfo import available_timezones
    from zoneinfo import reset_tzpath

__all__ = [
    "ZoneInfo",
    "reset_tzpath",
    "available_timezones",
    "TZPATH",
    "ZoneInfoNotFoundError",
    "InvalidTZPathWarning",
]