%PDF- %PDF-
| Direktori : /snap/certbot/5911/lib64/python3.12/site-packages/pyrfc3339/__pycache__/ |
| Current File : //snap/certbot/5911/lib64/python3.12/site-packages/pyrfc3339/__pycache__/parser.cpython-312.pyc |
�
�h�j, � �B � d dl Z d dlmZmZ ddlmZ d
dedededefd �Zy)� N)�UTC�datetime� )�datetime_utcoffset� timestamp�utc�
produce_naive�returnc �
� t j dd| t j �� } t j | � }|r|j t � }|r-t |� dk( r|j d�� }|S t d� �|S )ar
Parse an :RFC:`3339`-formatted timestamp and return a :class:`datetime.datetime`.
If the timestamp is presented in UTC, then the :attr:`~datetime.datetime.tzinfo` attribute of the
returned `datetime` will be set to :attr:`datetime.timezone.utc`.
>>> parse('2009-01-01T10:01:02Z')
datetime.datetime(2009, 1, 1, 10, 1, 2, tzinfo=datetime.timezone.utc)
Otherwise, a :class:`datetime.timezone` instance is created with the appropriate offset, and
the :attr:`~datetime.datetime.tzinfo` attribute of the returned :class:`~datetime.datetime` is set to that value.
>>> parse('2009-01-01T14:01:02-04:00')
datetime.datetime(2009, 1, 1, 14, 1, 2, tzinfo=datetime.timezone(datetime.timedelta(days=-1, seconds=72000)))
However, if :meth:`parse()` is called with :python:`utc=True`, then the returned
:class:`~datetime.datetime` will be normalized to UTC (and its :attr:`~datetime.datetime.tzinfo` attribute set to
:attr:`~datetime.timezone.utc`), regardless of the input timezone.
>>> parse('2009-01-01T06:01:02-04:00', utc=True)
datetime.datetime(2009, 1, 1, 10, 1, 2, tzinfo=datetime.timezone.utc)
As parsing is delegated to :meth:`datetime.datetime.fromisoformat()`, certain
timestamps which do not strictly adhere to :RFC:`3339` are nonetheless accepted.
>>> parse('2009-01-01T06:01:02')
datetime.datetime(2009, 1, 1, 6, 1, 2)
Exceptions will, however, be thrown for blatantly invalid input:
>>> parse('2009-01-01T25:01:02Z') # doctest: +IGNORE_EXCEPTION_DETAIL
Traceback (most recent call last):
...
ValueError: hour must be in 0..23
:param str timestamp: the :RFC:`3339` timestamp to be parsed
:param bool utc: :const:`True` to normalize the timestamp to UTC; :const:`False` otherwise. Defaults to :const:`False`.
:param bool produce_naive: :const:`True` if the produced :class:`~datetime.datetime` instance should
not have a timezone attached (that is, be 'naive'); :const:`False` otherwise.
Defaults to :const:`False`.
:return: the parsed timestamp
:rtype: datetime.datetime
zZ$z+00:00)�flagsr N)�tzinfoz6cannot produce a naive datetime from a local timestamp)
�re�sub�
IGNORECASEr �
fromisoformat�
astimezoner r �replace�
ValueError)r r r �dt_outs �L/root/parts/certbot/install/lib/python3.12/site-packages/pyrfc3339/parser.py�parser sz � �` ���t�X�y��
�
�F�I�
�
#�
#�I�
.�F�
��"�"�3�'����f�%��*��^�^�4�^�0�F� �M� �U�V�V��M� )FF)r r r �utilsr �str�boolr � r r �<module>r s/ �� � "� %�=�S� =�t� =�D� =�X� =r