o #a,@sdZddlZddlmZmZddlmZddlmZddlm Z ddl m Z m Z m Z mZmZmZmZddlmZdd lmZdd lmZmZdd lmZdd lmZmZGd ddZdS)z Implements the :class:`ArrowFactory ` class, providing factory methods for common :class:`Arrow ` construction scenarios. N)datedatetimetzinfo)Decimal) struct_time)AnyListOptionalTupleTypeUnionoverload)tz)parser)TZ_EXPRArrow)DEFAULT_LOCALE) is_timestampiso_to_gregorianc@sleZdZUdZeeed<efdeeddfddZee dddd e d e e d e defd d Zee ddddeeeeeeeee eeeeff d e d e e d e def dd Zee ddddeeefde d e d e e d e def dd Zee dddde dee ee fd e d e e d e def dd Zdededefdd ZdefddZdde e defddZdS) ArrowFactoryzA factory for generating :class:`Arrow ` objects. :param type: (optional) the :class:`Arrow `-based class to construct from. Defaults to :class:`Arrow `. typereturnNcCs ||_dSN)r)selfrr1usr/lib/python3.10/site-packages/arrow/factory.py__init__"s zArrowFactory.__init__F)localernormalize_whitespacerrrcCdSrr)rrrrrrrget%szArrowFactory.get_ArrowFactory__objcCr rr)rr"rrrrrrr!/s_ArrowFactory__arg1_ArrowFactory__arg2cCr rrrr#r$rrrrrrr!D cCr rrr%rrrr!Pr&argskwargsc Os t|}|dt}|dd}|dd}t|dkrd}t|dkr*|dur*d}|dkrQt|tr@tj|}|j j |d St|t rL|j j |d S|j S|dkr|d}t|t rbt|}|durjtd t|tst|r|dur{t}|j j||d St|tr|j j|j|d St|tr|j j||d St|tr|j j||d St|t r|j j |d St|trt|||}|j j||d St|tr|j t|St|trt|dkrt |} |j j| |d Std t |d |d kr}|d|d} } t| tr*t| t tfr |j j| | d Stdt | d t| trJt| t tfr@|j j| | d Stdt | d t| trnt| tt!frnt||d|d|}|j j||d Stdt | dt | d |j |i|S)aReturns an :class:`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 ` 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() **One** :class:`Arrow ` object, to get a copy. >>> arw = arrow.utcnow() >>> arrow.get(arw) **One** ``float`` or ``int``, convertible to a floating-point timestamp, to get that timestamp in UTC:: >>> arrow.get(1367992474.293378) >>> arrow.get(1367992474) **One** ISO 8601-formatted ``str``, to parse it:: >>> arrow.get('2013-09-29T01:26:43.830580') **One** ISO 8601-formatted ``str``, in basic format, to parse it:: >>> arrow.get('20160413T133656.456289') **One** ``tzinfo``, to get the current time **converted** to that timezone:: >>> arrow.get(tz.tzlocal()) **One** naive ``datetime``, to get that datetime in UTC:: >>> arrow.get(datetime(2013, 5, 5)) **One** aware ``datetime``, to get that datetime:: >>> arrow.get(datetime(2013, 5, 5, tzinfo=tz.tzlocal())) **One** naive ``date``, to get that date in UTC:: >>> arrow.get(date(2013, 5, 5)) **One** time.struct time:: >>> arrow.get(gmtime(0)) **One** iso calendar ``tuple``, to get that week date in UTC:: >>> arrow.get((2013, 18, 7)) **Two** arguments, a naive or aware ``datetime``, and a replacement :ref:`timezone expression `:: >>> arrow.get(datetime(2013, 5, 5), 'US/Pacific') **Two** arguments, a naive ``date``, and a replacement :ref:`timezone expression `:: >>> arrow.get(date(2013, 5, 5), 'US/Pacific') **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') **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']) **Three or more** arguments, as for the direct constructor of an ``Arrow`` object:: >>> arrow.get(2013, 5, 5, 12, 30, 45) rrNrFrrz#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 )"lenpoprr! isinstancestrr TzinfoParserparsernow dt_tzinfoutcnowrfloat TypeErrorr dateutil_tzZtzutc fromtimestamprZ fromdatetimerrZfromdateZDateTimeParserZ parse_isorutcfromtimestampcalendartimegmtuplerlist) rr'r(Z arg_countrrrargdtdZarg_1Zarg_2rrrr!\sh                   cCs |jS)zReturns an :class:`Arrow ` object, representing "now" in UTC time. Usage:: >>> import arrow >>> arrow.utcnow() )rr5)rrrrr55s zArrowFactory.utcnowrcCs4|dur t}n t|tstj|}|j|S)aiReturns an :class:`Arrow ` object, representing "now" in the given timezone. :param tz: (optional) A :ref:`timezone expression `. Defaults to local time. Usage:: >>> import arrow >>> arrow.now() >>> arrow.now('US/Pacific') >>> arrow.now('+02:00') >>> arrow.now('local') N) r8Ztzlocalr/r4rr1r2rr3)rrrrrr3As     zArrowFactory.nowr)__name__ __module__ __qualname____doc__r r__annotations__rrrr0r rboolr!r rrrr4intr6r r rr5r3rrrrrs           Z r) rEr;rrrr4Zdecimalrtimertypingrr r r r r rZdateutilrr8arrowrZ arrow.arrowrrZarrow.constantsrZ arrow.utilrrrrrrrs   $