U j @sdZddlmZddlZddlmZmZmZddlmZm Z ddl m Z ddl m Z dd lmZGd d d Zd d dddZd d dddZd ddddZddddZd dddZd dddZd ddddddgZdS)z Utility functions for icalendar.) annotationsN)datedatetimetzinfo) ascii_lettersdigits)warn) to_unicode)WillBeRemovedInVersion7c@s>eZdZdZeeeZed ddddZ ed d d Z d S) UIDGeneratorzUse this only if you're too lazy to create real UUIDs. .. deprecated:: 6.2.1 Use the Python standard library's :func:`uuid.uuid4` instead. str)returncCs&tdtdddddt|DS)zGenerates a string with random characters of length. .. deprecated:: 6.2.1 Use the Python standard library's :func:`uuid.uuid4` instead. zCUse https://docs.python.org/3/library/uuid.html#uuid.uuid4 instead.r  stacklevelcSsg|]}ttjqS)randomchoicer chars).0_rr3/tmp/pip-unpacked-wheel-g40nyxg1/icalendar/tools.py &sz+UIDGenerator.rnd_string..)rr joinrange)lengthrrr rnd_strings zUIDGenerator.rnd_string example.comrcCs^ddlm}m}tdtddt|}|p0t}t|t  }||d|d|S)a@Generates a unique ID consisting of ``datetime-uniquevalue@host``. For example: .. code-block:: text 20050105T225746Z-HKtJMqUgdO0jDUwm@example.com .. deprecated:: 6.2.1 Use the Python standard library's :func:`uuid.uuid5` instead. r) vDatetimevTextzCUse https://docs.python.org/3/library/uuid.html#uuid.uuid5 instead.r r-@) Zicalendar.propr r!rr r r rrtodayZto_ical)Z host_nameuniquer r!r$rrruid(s zUIDGenerator.uidN)r )rr) __name__ __module__ __qualname____doc__listrrr staticmethodrr&rrrrr s  r rbool)dtrcCst|tot|t Sz*Whether this is a date and not a datetime.) isinstancerrr.rrris_dateCsr2cCs t|tSr/)r0rr1rrr is_datetimeHsr3rcCst|rt|j|j|jS|S)z)Make sure we have a datetime, not a date.)r2ryearmonthdayr1rrr to_datetimeMsr7rtzcCs t|dS)z9Whether the timezone requires localize() and normalize().Zlocalize)hasattrr8rrris_pytzTsr;r1cCst|ot|jS)z5Whether the time requires localize() and normalize().)r3r;rr1rrr is_pytz_dtYsr<cCst|r|j|S|S)zWe have to normalize the time after a calculation if we use pytz. pytz requires this function to be used in order to correctly calculate the timezone's offset after calculations. )r<r normalizer1rrrnormalize_pytz^s r>)r* __future__rrrrrstringrrwarningsrZicalendar.parser_toolsr errorr r r2r3r7r;r<r>__all__rrrrs,    4