o .j@sdZddlmZddlmZmZmZddlmZmZer$ddl m Z m Z dd d Z dd dZ dddZd ddZd!ddZd"ddZgdZdS)#z Utility functions for icalendar.) annotations)datedatetimetzinfo) TYPE_CHECKINGcast) TypeGuardTypeIsdtdate | datetimereturnboolcCst|to t|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 rD/home/thesage/.local/lib/python3.10/site-packages/icalendar/tools.pyis_date srTypeIs[datetime]cCs 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 )rrrrrr is_datetime&s rrcCs$t|r t|j|j|jStd|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)rryearmonthdayrrrrr to_datetime=s rtzrcCs 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)rrrris_pytzYs rTypeGuard[datetime]cCst|o|j}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 rrrr is_pytz_dtis rcCst|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. )rr normalizerrrrnormalize_pytzys r )rrrrr 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.compatibilityrr rrrrrr __all__rrrrs