"""Use pytz timezones."""
from __future__ import annotations
import pytz
from .. import cal
from datetime import datetime, tzinfo
from pytz.tzinfo import DstTzInfo
from typing import Optional
from .provider import TZProvider
from icalendar import prop
from dateutil.rrule import rrule
class PYTZ(TZProvider):
"""Provide icalendar with timezones from pytz."""
name = "pytz"
def localize_utc(self, dt: datetime) -> datetime:
"""Return the datetime in UTC."""
if getattr(dt, "tzinfo", False) and dt.tzinfo is not None:
return dt.astimezone(pytz.utc)
# assume UTC for naive datetime instances
return pytz.utc.localize(dt)
def localize(self, dt: datetime, tz: tzinfo) -> datetime:
"""Localize a datetime to a timezone."""
return tz.localize(dt)
def knows_timezone_id(self, id: str) -> bool:
"""Whether the timezone is already cached by the implementation."""
return id in pytz.all_timezones
def fix_rrule_until(self, rrule: rrule, ical_rrule: prop.vRecur) -> None:
"""Make sure the until value works for the rrule generated from the ical_rrule."""
if not {"UNTIL", "COUNT"}.intersection(ical_rrule.keys()):
# pytz.timezones don't know any transition dates after 2038
# either
rrule._until = datetime(2038, 12, 31, tzinfo=pytz.UTC)
def create_timezone(self, tz: cal.Timezone) -> tzinfo:
"""Create a pytz timezone from the given information."""
transition_times, transition_info = tz.get_transitions()
name = tz.tz_name
cls = type(
name,
(DstTzInfo,),
{
"zone": name,
"_utc_transition_times": transition_times,
"_transition_info": transition_info,
},
)
return cls()
def timezone(self, name: str) -> Optional[tzinfo]:
"""Return a timezone with a name or None if we cannot find it."""
try:
return pytz.timezone(name)
except pytz.UnknownTimeZoneError:
pass
def uses_pytz(self) -> bool:
"""Whether we use pytz."""
return True
def uses_zoneinfo(self) -> bool:
"""Whether we use zoneinfo."""
return False
__all__ = ["PYTZ"]
