a
    ø£Be¨,  ã                   @   sº   d Z ddlZddlmZmZ ddlmZ ddlmZ ddlm	Z	 ddl
mZmZmZmZmZmZmZ ddlmZ dd	lmZ dd
lmZmZ ddlmZ ddlmZmZ G dd„ dƒZdS )z«
Implements the :class:`ArrowFactory <arrow.factory.ArrowFactory>` class,
providing factory methods for common :class:`Arrow <arrow.arrow.Arrow>`
construction scenarios.

é    N)ÚdateÚdatetime©Útzinfo)ÚDecimal)Ústruct_time)ÚAnyÚListÚOptionalÚTupleÚTypeÚUnionÚoverload)Útz)Úparser)ÚTZ_EXPRÚArrow)ÚDEFAULT_LOCALE)Úis_timestampÚiso_to_gregorianc                   @   sB  e Zd ZU dZee ed< efee ddœdd„Zee	dddœe
ee eed	œd
d„ƒZee	dddœeeeeeeeee
eeeef f	 e
ee eedœdd„ƒZee	dddœeeef ee
ee eedœdd„ƒZee	dddœe
ee
ee
 f e
ee eedœdd„ƒZeeedœdd„Zedœdd„Zdee edœdd„ZdS )ÚArrowFactoryzåA factory for generating :class:`Arrow <arrow.arrow.Arrow>` objects.

    :param type: (optional) the :class:`Arrow <arrow.arrow.Arrow>`-based class to construct from.
        Defaults to :class:`Arrow <arrow.arrow.Arrow>`.

    ÚtypeN)r   Úreturnc                 C   s
   || _ d S ©N)r   )Úselfr   © r   úP/home/yuhw/wc/wire-cell-python/wcpy/lib/python3.9/site-packages/arrow/factory.pyÚ__init__"   s    zArrowFactory.__init__F)Úlocaler   Únormalize_whitespace)r   r   r   r   c                C   s   d S r   r   )r   r   r   r   r   r   r   Úget%   s    zArrowFactory.get)Ú_ArrowFactory__objr   r   r   r   c                C   s   d S r   r   )r   r!   r   r   r   r   r   r   r    /   s    )Ú_ArrowFactory__arg1Ú_ArrowFactory__arg2r   r   r   r   c                C   s   d S r   r   ©r   r"   r#   r   r   r   r   r   r   r    D   s    
c                C   s   d S r   r   r$   r   r   r   r    P   s    
)ÚargsÚkwargsr   c                 O   s4  t |ƒ}| dt¡}| dd¡}| dd¡}t |ƒdkr<d}t |ƒdkrT|du rTd}|dkr¢t|tƒr€tj |¡}| j	j
|d	�S t|tƒr˜| j	j
|d	�S | j	 ¡ S |dk�r|d }t|tƒrÆt|ƒ}|du rÚtd
ƒ‚�q0t|tƒ�st|ƒ�r|du �rt ¡ }| j	j||d	�S t|tƒ�r0| j	j|j|d	�S t|tƒ�rL| j	j||d	�S t|tƒ�rh| j	j||d	�S t|tƒ�r‚| j	j
|d	�S t|tƒ�r°t |¡ ||¡}| j	j||d	�S t|tƒ�rÎ| j	 t |¡¡S t|tƒ�r t |ƒdk�r t |Ž }	| j	j|	|d	�S tdt	|ƒ›d�ƒ‚�n|dk�r |d |d  }
}t|
tƒ�rvt|ttfƒ�r`| j	j|
|d	�S tdt	|ƒ›d�ƒ‚n¨t|
tƒ�r¸t|ttfƒ�r¢| j	j|
|d	�S tdt	|ƒ›d�ƒ‚nft|
tƒ�r t|tt!fƒ�r t |¡ |d |d |¡}| j	j||d	�S tdt	|
ƒ›dt	|ƒ›d�ƒ‚n| j	|i |¤ŽS dS )aÔ  Returns an :class:`Arrow <arrow.arrow.Arrow>` object based on flexible inputs.

        :param locale: (optional) a ``str`` specifying a locale for the parser. Defaults to 'en-us'.
        :param tzinfo: (optional) a :ref:`timezone expression <tz-expr>` or tzinfo object.
            Replaces the timezone unless using an input form that is explicitly UTC or specifies
            the timezone in a positional argument. Defaults to UTC.
        :param normalize_whitespace: (optional) a ``bool`` specifying whether or not to normalize
            redundant whitespace (spaces, tabs, and newlines) in a datetime string before parsing.
            Defaults to false.

        Usage::

            >>> import arrow

        **No inputs** to get current UTC time::

            >>> arrow.get()
            <Arrow [2013-05-08T05:51:43.316458+00:00]>

        **One** :class:`Arrow <arrow.arrow.Arrow>` object, to get a copy.

            >>> arw = arrow.utcnow()
            >>> arrow.get(arw)
            <Arrow [2013-10-23T15:21:54.354846+00:00]>

        **One** ``float`` or ``int``, convertible to a floating-point timestamp, to get
        that timestamp in UTC::

            >>> arrow.get(1367992474.293378)
            <Arrow [2013-05-08T05:54:34.293378+00:00]>

            >>> arrow.get(1367992474)
            <Arrow [2013-05-08T05:54:34+00:00]>

        **One** ISO 8601-formatted ``str``, to parse it::

            >>> arrow.get('2013-09-29T01:26:43.830580')
            <Arrow [2013-09-29T01:26:43.830580+00:00]>

        **One** ISO 8601-formatted ``str``, in basic format, to parse it::

            >>> arrow.get('20160413T133656.456289')
            <Arrow [2016-04-13T13:36:56.456289+00:00]>

        **One** ``tzinfo``, to get the current time **converted** to that timezone::

            >>> arrow.get(tz.tzlocal())
            <Arrow [2013-05-07T22:57:28.484717-07:00]>

        **One** naive ``datetime``, to get that datetime in UTC::

            >>> arrow.get(datetime(2013, 5, 5))
            <Arrow [2013-05-05T00:00:00+00:00]>

        **One** aware ``datetime``, to get that datetime::

            >>> arrow.get(datetime(2013, 5, 5, tzinfo=tz.tzlocal()))
            <Arrow [2013-05-05T00:00:00-07:00]>

        **One** naive ``date``, to get that date in UTC::

            >>> arrow.get(date(2013, 5, 5))
            <Arrow [2013-05-05T00:00:00+00:00]>

        **One** time.struct time::

            >>> arrow.get(gmtime(0))
            <Arrow [1970-01-01T00:00:00+00:00]>

        **One** iso calendar ``tuple``, to get that week date in UTC::

            >>> arrow.get((2013, 18, 7))
            <Arrow [2013-05-05T00:00:00+00:00]>

        **Two** arguments, a naive or aware ``datetime``, and a replacement
        :ref:`timezone expression <tz-expr>`::

            >>> arrow.get(datetime(2013, 5, 5), 'US/Pacific')
            <Arrow [2013-05-05T00:00:00-07:00]>

        **Two** arguments, a naive ``date``, and a replacement
        :ref:`timezone expression <tz-expr>`::

            >>> arrow.get(date(2013, 5, 5), 'US/Pacific')
            <Arrow [2013-05-05T00:00:00-07:00]>

        **Two** arguments, both ``str``, to parse the first according to the format of the second::

            >>> arrow.get('2013-05-05 12:30:45 America/Chicago', 'YYYY-MM-DD HH:mm:ss ZZZ')
            <Arrow [2013-05-05T12:30:45-05:00]>

        **Two** arguments, first a ``str`` to parse and second a ``list`` of formats to try::

            >>> arrow.get('2013-05-05 12:30:45', ['MM/DD/YYYY', 'YYYY-MM-DD HH:mm:ss'])
            <Arrow [2013-05-05T12:30:45+00:00]>

        **Three or more** arguments, as for the direct constructor of an ``Arrow`` object::

            >>> arrow.get(2013, 5, 5, 12, 30, 45)
            <Arrow [2013-05-05T12:30:45+00:00]>

        r   r   Nr   Fé   é   r   r   z#Cannot parse argument of type None.z%Cannot parse single argument of type Ú.é   z0Cannot parse two arguments of types 'datetime', z,Cannot parse two arguments of types 'date', z$Cannot parse two arguments of types z and )"ÚlenÚpopr   r    Ú
isinstanceÚstrr   ÚTzinfoParserÚparser   ÚnowÚ	dt_tzinfoÚutcnowr   ÚfloatÚ	TypeErrorr   Údateutil_tzZtzutcÚfromtimestampr   Zfromdatetimer   r   ZfromdateZDateTimeParserZ	parse_isor   ÚutcfromtimestampÚcalendarÚtimegmÚtupler   Úlist)r   r%   r&   Ú	arg_countr   r   r   ÚargÚdtÚdZarg_1Zarg_2r   r   r   r    \   s‚    h






ÿÿ
ÿÿ)r   c                 C   s
   | j  ¡ S )zãReturns an :class:`Arrow <arrow.arrow.Arrow>` object, representing "now" in UTC time.

        Usage::

            >>> import arrow
            >>> arrow.utcnow()
            <Arrow [2013-05-08T05:19:07.018993+00:00]>
        )r   r3   )r   r   r   r   r3   2  s    
zArrowFactory.utcnow)r   r   c                 C   s4   |du rt  ¡ }nt|tƒs(tj |¡}| j |¡S )ai  Returns an :class:`Arrow <arrow.arrow.Arrow>` object, representing "now" in the given
        timezone.

        :param tz: (optional) A :ref:`timezone expression <tz-expr>`.  Defaults to local time.

        Usage::

            >>> import arrow
            >>> arrow.now()
            <Arrow [2013-05-07T22:19:11.363410-07:00]>

            >>> arrow.now('US/Pacific')
            <Arrow [2013-05-07T22:19:15.251821-07:00]>

            >>> arrow.now('+02:00')
            <Arrow [2013-05-08T07:19:25.618646+02:00]>

            >>> arrow.now('local')
            <Arrow [2013-05-07T22:19:39.130059-07:00]>
        N)	r6   Ztzlocalr-   r2   r   r/   r0   r   r1   )r   r   r   r   r   r1   >  s
    

zArrowFactory.now)N)Ú__name__Ú
__module__Ú__qualname__Ú__doc__r   r   Ú__annotations__r   r   r   r.   r
   r   Úboolr    r   r   r   r   r2   Úintr4   r   r	   r   r3   r1   r   r   r   r   r      s~   
ûú	ðøÿïù
øùø Wr   ) rD   r9   r   r   r   r2   Údecimalr   Útimer   Útypingr   r	   r
   r   r   r   r   Zdateutilr   r6   Úarrowr   Zarrow.arrowr   r   Zarrow.constantsr   Z
arrow.utilr   r   r   r   r   r   r   Ú<module>   s   $