idZddlmZddlmZmZmZddlmZmZerddl m Z m Z dd Z dd Z ddZddZddZddZgdZdS)z Utility functions for icalendar.) annotations)datedatetimetzinfo) TYPE_CHECKINGcast) TypeGuardTypeIsdtdate | datetimereturnboolcXt|tot|t S)aCheck if a value is a date but not a datetime. This function distinguishes between ``date`` and ``datetime`` objects, returning ``True`` only for pure ``date`` instances. Parameters: dt: The date or datetime object to check. Returns: ``True`` if the value is a ``date`` but not a ``datetime``, ``False`` otherwise. Example: .. code-block:: pycon >>> from datetime import date, datetime >>> from icalendar.tools import is_date >>> is_date(date(2024, 1, 15)) True >>> is_date(datetime(2024, 1, 15, 10, 30)) False ) isinstancerrr s J/root/projects/butler/venv/lib/python3.11/site-packages/icalendar/tools.pyis_dater s&. b$   @ 2x(@(@$@@TypeIs[datetime]c,t|tS)aCheck if a value is a datetime. Parameters: dt: The date or datetime object to check. Returns: ``True`` if the value is a ``datetime``, ``False`` if it is only a ``date``. Example: .. code-block:: pycon >>> from datetime import date, datetime >>> from icalendar.tools import is_datetime >>> is_datetime(datetime(2024, 1, 15, 10, 30)) True >>> is_datetime(date(2024, 1, 15)) False )rrrs r is_datetimer&s( b( # ##rrct|r t|j|j|jSt d|S)aConvert a date to a datetime. If the input is already a ``datetime``, it is returned unchanged. If the input is a ``date``, it is converted to a ``datetime`` at midnight. Parameters: dt: The date or datetime to convert. Returns: A ``datetime`` object. If the input was a ``date``, the time component will be set to midnight (00:00:00). Example: .. code-block:: pycon >>> from datetime import date, datetime >>> from icalendar.tools import to_datetime >>> to_datetime(date(2024, 1, 15)) datetime.datetime(2024, 1, 15, 0, 0) >>> to_datetime(datetime(2024, 1, 15, 10, 30)) datetime.datetime(2024, 1, 15, 10, 30) r)rryearmonthdayrrs r to_datetimer=s:.r{{326222  B  rtzrc"t|dS)aoCheck if a timezone is a pytz timezone. pytz timezones require special handling with ``localize()`` and ``normalize()`` methods for correct timezone calculations. Parameters: tz: The timezone info object to check. Returns: ``True`` if the timezone is a pytz timezone (has a ``localize`` attribute), ``False`` otherwise. localize)hasattr)rs ris_pytzr!Ys 2z " ""rTypeGuard[datetime]cTt|o|jx}duot|S)avCheck if a datetime uses a pytz timezone. This function checks whether the datetime has a timezone attached and whether that timezone is a pytz timezone requiring special handling. Parameters: dt: The date or datetime object to check. Returns: ``True`` if the value is a ``datetime`` with a pytz timezone, ``False`` otherwise. N)rrr!)r rs r is_pytz_dtr$is, r?? T") 3D@ TWV__TrcXt|r|j|S|S)aNormalize a datetime after calculations when using pytz. pytz requires the ``normalize()`` function to be called after arithmetic operations to correctly adjust the timezone offset, especially around daylight saving time transitions. Parameters: dt: The date or datetime to normalize. Returns: The normalized datetime if it uses pytz, otherwise the input unchanged. )r$r normalizers rnormalize_pytzr'ys-"~~'y""2&&& Ir)rrr!r$r'rN)r r r r)r r r r)r r r r)rrr r)r r r r")r r r r )__doc__ __future__rrrrtypingrricalendar.compatibilityr r rrrr!r$r'__all__rrr.s&&""""""++++++++++&&&&&&&&:99999999AAAA4$$$$.    8 # # # # U U U U $   r