Google
Edit File: isoparser.cpython-39.pyc
a &�i�3 � @ s| d Z ddlmZmZmZmZ ddlZddlmZ ddlm Z ddl Z ddl Z ddgZ dd � Z G d d� de�Ze� ZejZdS ) z� This module offers a parser for ISO-8601 strings It is intended to support all valid date, time and datetime formats per the ISO-8601 specification. ..versionadded:: 2.7.0 � )�datetime� timedelta�time�dateN)�tz��wraps�isoparse� isoparserc s t � �� fdd��}|S )Nc s� t � d� fdd��� � t� tj�rjz� �d�� W n8 tyh } z d}t�t|�|� W Y d }~n d }~0 0 �| � g|�R i |��S )N�readc s � S �N� r ��str_inr �=/usr/lib/python3.9/site-packages/dateutil/parser/isoparser.py�<lambda> � z,_takes_ascii.<locals>.func.<locals>.<lambda>�asciiz5ISO-8601 strings should contain only ASCII characters)�getattr� isinstance�sixZ text_type�encode�UnicodeEncodeErrorZ raise_from� ValueError)�selfr �args�kwargs�e�msg��fr r �func s &z_takes_ascii.<locals>.funcr )r r! r r r � _takes_ascii s r" c @ s� e Zd Zd dd�Zedd� �Zedd� �Zedd � �Zed d d ��Zd Z dZ e � d�Z dd� Zdd� Zdd� Zdd� Zdd� Zd dd�ZdS ) r Nc C sD |dur:t |�dks(t|�dks(|dv r0td��|�d�}|| _dS )z� :param sep: A single character that separates date and time portions. If ``None``, the parser will accept any single character. For strict ISO-8601 adherence, pass ``'T'``. N� � � 0123456789z7Separator must be a single, non-numeric ASCII characterr )�len�ordr r �_sep)r �sepr r r �__init__+ s zisoparser.__init__c C s� | � |�\}}t|�|kr^| jdu s:|||d � | jkrV|| �||d d� �7 }ntd��t|�dkr�|d dkr�d|d< t|� tdd� S t|� S )u Parse an ISO-8601 datetime string into a :class:`datetime.datetime`. An ISO-8601 datetime string consists of a date portion, followed optionally by a time portion - the date and time portions are separated by a single character separator, which is ``T`` in the official standard. Incomplete date formats (such as ``YYYY-MM``) may *not* be combined with a time portion. Supported date formats are: Common: - ``YYYY`` - ``YYYY-MM`` - ``YYYY-MM-DD`` or ``YYYYMMDD`` Uncommon: - ``YYYY-Www`` or ``YYYYWww`` - ISO week (day defaults to 0) - ``YYYY-Www-D`` or ``YYYYWwwD`` - ISO week and day The ISO week and day numbering follows the same logic as :func:`datetime.date.isocalendar`. Supported time formats are: - ``hh`` - ``hh:mm`` or ``hhmm`` - ``hh:mm:ss`` or ``hhmmss`` - ``hh:mm:ss.ssssss`` (Up to 6 sub-second digits) Midnight is a special case for `hh`, as the standard supports both 00:00 and 24:00 as a representation. The decimal separator can be either a dot or a comma. .. caution:: Support for fractional components other than seconds is part of the ISO-8601 standard, but is not currently implemented in this parser. Supported time zone offset formats are: - `Z` (UTC) - `±HH:MM` - `±HHMM` - `±HH` Offsets will be represented as :class:`dateutil.tz.tzoffset` objects, with the exception of UTC, which will be represented as :class:`dateutil.tz.tzutc`. Time zone offsets equivalent to UTC (such as `+00:00`) will also be represented as :class:`dateutil.tz.tzutc`. :param dt_str: A string or stream containing only an ISO-8601 datetime string :return: Returns a :class:`datetime.datetime` representing the string. Unspecified components default to their lowest value. .. warning:: As of version 2.7.0, the strictness of the parser should not be considered a stable part of the contract. Any valid ISO-8601 string that parses correctly with the default settings will continue to parse correctly in future versions, but invalid strings that currently fail (e.g. ``2017-01-01T00:00+00:00:00``) are not guaranteed to continue failing in future versions if they encode a valid date. .. versionadded:: 2.7.0 Nr# z&String contains unknown ISO components� � r �Zdays)�_parse_isodater& r( �_parse_isotimer r r )r �dt_str� components�posr r r r ; s K zisoparser.isoparsec C s: | � |�\}}|t|�k r2tdd�|�d�� ��t|� S )z� Parse the date portion of an ISO string. :param datestr: The string portion of an ISO string, without a separator :return: Returns a :class:`datetime.date` object z String contains unknown ISO zcomponents: {!r}r )r. r& r �format�decoder )r Zdatestrr1 r2 r r r � parse_isodate� s �zisoparser.parse_isodatec C s& | � |�}|d dkr d|d< t|� S )z� Parse the time portion of an ISO string. :param timestr: The time portion of an ISO string, without a separator :return: Returns a :class:`datetime.time` object r r, )r/ r )r �timestrr1 r r r � parse_isotime� s zisoparser.parse_isotimeTc C s | j ||d�S )a Parse a valid ISO time zone string. See :func:`isoparser.isoparse` for details on supported formats. :param tzstr: A string representing an ISO time zone offset :param zero_as_utc: Whether to return :class:`dateutil.tz.tzutc` for zero-offset zones :return: Returns :class:`dateutil.tz.tzoffset` for offsets and :class:`dateutil.tz.tzutc` for ``Z`` and (if ``zero_as_utc`` is specified) offsets equivalent to UTC. )� zero_as_utc)� _parse_tzstr)r �tzstrr8 r r r � parse_tzstr� s zisoparser.parse_tzstr� -� :s [\.,]([0-9]+)c C s. z | � |�W S ty( | �|� Y S 0 d S r )�_parse_isodate_commonr �_parse_isodate_uncommon)r r0 r r r r. � s zisoparser._parse_isodatec C s t |�}g d�}|dk r td��t|dd� �|d< d}||krH||fS |||d � | jk}|rj|d7 }|| dk r~td��t|||d � �|d< |d7 }||kr�|r�||fS td��|r�|||d � | jkr�td ��|d7 }|| dk r�td ��t|||d � �|d< ||d fS ) N)r# r# r# � �ISO string too shortr r# � zInvalid common monthzInvalid ISO formatz Invalid separator in ISO stringzInvalid common day)r& r �int� _DATE_SEP)r r0 �len_strr1 r2 �has_sepr r r r> � s6 z isoparser._parse_isodate_commonc C st t |�dk rtd��t|dd� �}|dd� | jk}d| }|||d � dkr�|d7 }t|||d � �}|d7 }d}t |�|kr�|||d � | jk|kr�td��||7 }t|||d � �}|d7 }| �|||�}n�t |�| d k r�td ��t|||d � �}|d 7 }|dk �s.|d t�|� k�rBtd d �||� ��t|dd�t |d d � }|j |j |j g} | |fS )Nr@ rA r � r# � WrB z"Inconsistent use of dash separatorr+ zInvalid ordinal dayim z {} for year {}r- ) r& r rC rD �_calculate_weekdate�calendarZisleapr3 r r �yearZmonth�day) r r0 rK rF r2 ZweeknoZdaynoZ base_dateZ ordinal_dayr1 r r r r? � s8 �z!isoparser._parse_isodate_uncommonc C s� d| k rdk s$n t d�|���d| k r8dk sHn t d�|���t|dd�}|t|�� d d d � }|d d |d }|t|d � S ) a� Calculate the day of corresponding to the ISO year-week-day calendar. This function is effectively the inverse of :func:`datetime.date.isocalendar`. :param year: The year in the ISO calendar :param week: The week in the ISO calendar - range is [1, 53] :param day: The day in the ISO calendar - range is [1 (MON), 7 (SUN)] :return: Returns a :class:`datetime.date` r �6 zInvalid week: {}� zInvalid weekday: {}r# r@ rB r- � )r r3 r r Z isocalendar)r rK ZweekrL Zjan_4Zweek_1Z week_offsetr r r rI ) s z isoparser._calculate_weekdatec C s� t |�}g d�}d}d}|dk r(td��d}||k �rf|dk �rf|d7 }|||d � d v rz| �||d � �|d< |}�qf|dkr�|||d � | jkr�d }|d7 }n2|dkr�|r�|||d � | jkr�td ��|d7 }|d k �rt|||d � �||< |d7 }|d kr,| j�||d � �}|�s&q,|�d�d d � }t|�dd t |� ||< |t |�� �7 }q,||k �rxtd��|d dk�r�tdd� |dd� D ���r�td��|S )N)r r r r Nr ���rB zISO time too shortFrG r# s -+ZzTz#Inconsistent use of colon separatorr+ � � z Unused components in ISO stringr, c s s | ]}|d kV qdS )r Nr )�.0Z componentr r r � <genexpr>z r z+isoparser._parse_isotime.<locals>.<genexpr>r@ z#Hour may only be 24 at 24:00:00.000) r& r r9 � _TIME_SEPrC �_FRACTION_REGEX�match�group�any) r r6 rE r1 r2 �comprF ZfracZus_strr r r r/ J sH zisoparser._parse_isotimec C s |dks|dkrt jS t|�dvr*td��|dd� dkr@d}n |dd� d krVd}ntd ��t|dd � �}t|�d kr�d}n&t||d d � | jkr�d nd d � �}|r�|dkr�|dkr�t jS |d kr�td��|dkr�td��t �d ||d | d �S d S )N� Z� z> r+ rG rQ z0Time zone offset must be 1, 3, 5 or 6 charactersr r# r< rP � +z Time zone offset requires signr+ r@ �; z#Invalid minutes in time zone offset� z!Invalid hours in time zone offset�< )r ZUTCr& r rC rU Ztzoffset)r r: r8 ZmultZhoursZminutesr r r r9 s( &zisoparser._parse_tzstr)N)T)T)�__name__� __module__� __qualname__r* r" r r5 r7 r; rD rU �re�compilerV r. r> r? rI r/ r9 r r r r r * s$ X ),!5)�__doc__r r r r rJ Zdateutilr � functoolsr rd r �__all__r" �objectr ZDEFAULT_ISOPARSERr r r r r �<module> s w