3
���h�2 � @ s� d dl mZ d dlmZ d dlmZmZmZ ed �ZddgZdd� Z e
ed�rZdd d�Z nG d
d � d e�Z dd d�Z d
d� Z
G dd� de�ZG dd� de�ZdS )� )�PY2)�wraps)�datetime� timedelta�tzinfo�tzname_in_python2�enfoldc s$ t r t� �� fdd��}|S � S dS )z�Change unicode output into bytestrings in Python 2
tzname() API changed in Python 3. It used to return bytes, but was changed
to unicode strings
c s � | |�}|d k r|j � }|S )N)�encode)�args�kwargs�name)�namefunc� �>/tmp/pip-build-5_djhm0z/python-dateutil/dateutil/tz/_common.py�adjust_encoding s
z*tzname_in_python2.<locals>.adjust_encodingN)r r )r
r r )r
r r
s �fold� c C s | j |d�S )a�
Provides a unified interface for assigning the ``fold`` attribute to
datetimes both before and after the implementation of PEP-495.
:param fold:
The value for the ``fold`` attribute in the returned datetime. This
should be either 0 or 1.
:return:
Returns an object for which ``getattr(dt, 'fold', 0)`` returns
``fold`` for all versions of Python. In versions prior to
Python 3.6, this is a ``_DatetimeWithFold`` object, which is a
subclass of :py:class:`datetime.datetime` with the ``fold``
attribute added, if ``fold`` is 1.
.. versionadded:: 2.6.0
)r )�replace)�dtr r r r r % s c @ s( e Zd ZdZf Zdd� Zedd� �ZdS )�_DatetimeWithFoldz�
This is a class designed to provide a PEP 495-compliant interface for
Python versions before 3.6. It is used only for dates in a fold, so
the ``fold`` attribute is fixed at ``1``.
.. versionadded:: 2.6.0
c O s~ d }x4t ||�D ]&\}}||kr.td j|���|||< qW x"|D ]}||kr@t| |�||< q@W |jd
d �rp| jnt}|f |�S )
a�
Return a datetime with the same attributes, except for those
attributes given new values by whichever keyword arguments are
specified. Note that tzinfo=None can be specified to create a naive
datetime from an aware datetime with no conversion of date and time
data.
This is reimplemented in ``_DatetimeWithFold`` because pypy3 will
return a ``datetime.datetime`` even if ``fold`` is unchanged.
�year�month�day�hour�minute�second� microsecondr zDuplicate argument: {}r r )r r r r r r r r )�zip� TypeError�format�getattr�get� __class__r )�selfr
r Zargnames�argZargnameZdt_classr r r r D s
z_DatetimeWithFold.replacec C s dS )Nr r )r# r r r r b s z_DatetimeWithFold.foldN)�__name__�
__module__� __qualname__�__doc__� __slots__r �propertyr r r r r r : s r c C sL t | dd�|kr| S | j� dd� }|| j| jf7 }|r@t|� S t|� S dS )a�
Provides a unified interface for assigning the ``fold`` attribute to
datetimes both before and after the implementation of PEP-495.
:param fold:
The value for the ``fold`` attribute in the returned datetime. This
should be either 0 or 1.
:return:
Returns an object for which ``getattr(dt, 'fold', 0)`` returns
``fold`` for all versions of Python. In versions prior to
Python 3.6, this is a ``_DatetimeWithFold`` object, which is a
subclass of :py:class:`datetime.datetime` with the ``fold``
attribute added, if ``fold`` is 1.
.. versionadded:: 2.6.0
r r N� )r � timetupler r r r )r r r
r r r r f s c s t � �� fdd��}|S )z�
The CPython version of ``fromutc`` checks that the input is a ``datetime``
object and that ``self`` is attached as its ``tzinfo``.
c s. t |t�std��|j| k r$td��� | |�S )Nz&fromutc() requires a datetime argumentzdt.tzinfo is not self)�
isinstancer r r �
ValueError)r# r )�fr r �fromutc� s
z)_validate_fromutc_inputs.<locals>.fromutc)r )r/ r0 r )r/ r �_validate_fromutc_inputs� s r1 c @ s< e Zd ZdZdd� Zdd� Zdd� Zdd � Zed
d � �Z d S )
�_tzinfoz=
Base class for all ``dateutil`` ``tzinfo`` objects.
c C sV |j | d�}t|dd�}t|dd�}|j� |j� k}|j dd�|j dd�k}|oT| S )a6
Whether or not the "wall time" of a given datetime is ambiguous in this
zone.
:param dt:
A :py:class:`datetime.datetime`, naive or time zone aware.
:return:
Returns ``True`` if ambiguous, ``False`` otherwise.
.. versionadded:: 2.6.0
)r r )r r N)r r � utcoffset)r# r Zwall_0Zwall_1Z same_offsetZsame_dtr r r � is_ambiguous� s z_tzinfo.is_ambiguousc C s4 | j |�r,|| }t||j� |j� k�}nd}|S )a�
Determine the fold status of a "wall" datetime, given a representation
of the same datetime as a (naive) UTC datetime. This is calculated based
on the assumption that ``dt.utcoffset() - dt.dst()`` is constant for all
datetimes, and that this offset is the actual number of hours separating
``dt_utc`` and ``dt_wall``.
:param dt_utc:
Representation of the datetime as UTC
:param dt_wall:
Representation of the datetime as "wall time". This parameter must
either have a `fold` attribute or have a fold-naive
:class:`datetime.tzinfo` attached, otherwise the calculation may
fail.
r )r4 �intr3 �dst)r# �dt_utc�dt_wallZ
delta_wall�_foldr r r � _fold_status� s
z_tzinfo._fold_statusc C s t |dd�S )Nr r )r )r# r r r r r9 � s z
_tzinfo._foldc C sh |j � }|dkrtd��|j� }|dkr0td��|| }||7 }t|dd�j� }|dkr`td��|| S )a�
Given a timezone-aware datetime in a given timezone, calculates a
timezone-aware datetime in a new timezone.
Since this is the one time that we *know* we have an unambiguous
datetime object, we take this opportunity to determine whether the
datetime is ambiguous and in a "fold" state (e.g. if it's the first
occurrence, chronologically, of the ambiguous datetime).
:param dt:
A timezone-aware :class:`datetime.datetime` object.
Nz0fromutc() requires a non-None utcoffset() resultz*fromutc() requires a non-None dst() resultr )r z;fromutc(): dt.dst gave inconsistent results; cannot convert)r3 r. r6 r )r# r ZdtoffZdtdst�deltar r r �_fromutc� s z_tzinfo._fromutcc C s" | j |�}| j||�}t||d�S )a�
Given a timezone-aware datetime in a given timezone, calculates a
timezone-aware datetime in a new timezone.
Since this is the one time that we *know* we have an unambiguous
datetime object, we take this opportunity to determine whether the
datetime is ambiguous and in a "fold" state (e.g. if it's the first
occurrence, chronologically, of the ambiguous datetime).
:param dt:
A timezone-aware :class:`datetime.datetime` object.
)r )r< r: r )r# r r8 r9 r r r r0 � s
z_tzinfo.fromutcN)
r% r& r' r( r4 r: r9 r< r1 r0 r r r r r2 � s %r2 c @ sz e Zd ZdZdd� Zdd� Zdd� Zedd � �Zd
d � Z d d
� Z
dd� Z dd� Z e
dd� �ZdZdd� Zdd� ZejZdS )� tzrangebasea�
This is an abstract base class for time zones represented by an annual
transition into and out of DST. Child classes should implement the following
methods:
* ``__init__(self, *args, **kwargs)``
* ``transitions(self, year)`` - this is expected to return a tuple of
datetimes representing the DST on and off transitions in standard
time.
A fully initialized ``tzrangebase`` subclass should also provide the
following attributes:
* ``hasdst``: Boolean whether or not the zone uses DST.
* ``_dst_offset`` / ``_std_offset``: :class:`datetime.timedelta` objects
representing the respective UTC offsets.
* ``_dst_abbr`` / ``_std_abbr``: Strings representing the timezone short
abbreviations in DST and STD, respectively.
* ``_hasdst``: Whether or not the zone has DST.
.. versionadded:: 2.6.0
c C s t d��d S )Nz%tzrangebase is an abstract base class)�NotImplementedError)r# r r r �__init__! s ztzrangebase.__init__c C s* | j |�}|d krd S |r | jS | jS d S )N)�_isdst� _dst_offset� _std_offset)r# r �isdstr r r r3 $ s
ztzrangebase.utcoffsetc C s( | j |�}|d krd S |r | jS tS d S )N)r@ �_dst_base_offset�ZERO)r# r rC r r r r6 . s
ztzrangebase.dstc C s | j |�r| jS | jS d S )N)r@ Z _dst_abbrZ _std_abbr)r# r r r r �tzname8 s
ztzrangebase.tznamec
C s� t |t�std��|j| k r$td��| j|j�}|dkrF|| j|� S |\}}|| j8 }|| j8 }||f}|j dd�}| j
||�}|r�|| j }n
|| j }t | o�| j
|��} t|| d�S )z, Given a datetime in UTC, return local time z&fromutc() requires a datetime argumentzdt.tzinfo is not selfN)r )r )r- r r r r. � transitionsr r3 rB r � _naive_isdstrA r5 r4 r )
r# r rG �dston�dstoffZutc_transitionsr7 rC r8 r9 r r r r0 ? s$
ztzrangebase.fromutcc C sD | j s
dS | j|j�\}}|jdd�}|| ko>|| j k S S )a6
Whether or not the "wall time" of a given datetime is ambiguous in this
zone.
:param dt:
A :py:class:`datetime.datetime`, naive or time zone aware.
:return:
Returns ``True`` if ambiguous, ``False`` otherwise.
.. versionadded:: 2.6.0
FN)r )�hasdstrG r r rD )r# r �start�endr r r r4 ` s
ztzrangebase.is_ambiguousc C sj | j s
dS |d krd S | j|j�}|d kr.dS |jd d�}| j||�}| rb| j|�rb| j|� S |S d S )NF)r )rK rG r r rH r4 r9 )r# r rG rC r r r r@ v s ztzrangebase._isdstc C sT |\}}|j d d�}||k r6|| ko.|k n }n|| koH|k n }|S )N)r )r )r# r rG rI rJ rC r r r rH � s ztzrangebase._naive_isdstc C s | j | j S )N)rA rB )r# r r r rD � s z tzrangebase._dst_base_offsetNc C s
| |k S )Nr )r# �otherr r r �__ne__� s ztzrangebase.__ne__c C s d| j j S )Nz%s(...))r" r% )r# r r r �__repr__� s ztzrangebase.__repr__)r% r& r' r( r? r3 r6 r rF r0 r4 r@ rH r* rD �__hash__rO rP �object�
__reduce__r r r r r= s
! r= N)r )r )�sixr � functoolsr r r r rE �__all__r �hasattrr r r1 r2 r= r r r r �<module> s
,
v |