o c@sdZddlmZmZmZddlZddlZddlZddlZddl Z ddl Z ddl Z ddl Z ddlmZmZmZddlmZmZddlmZdZd Zd Zd Zd Zd ZdZdZzddlm Z Wne!ynGdddej"Z Ynwe#e$Z%e%&e dZ'e(ddeDZ)ddZ*ddZ+ddZ,ddZ-e-Z.[-e/gdZ0e/gdZ1d d!Z2dZ3d"Z4Gd#d$d$e5Z6d%d&Z7Gd'd(d(e5Z8dS))zRparsedatetime Parse human-readable date/time text. Requires Python 2.7 or later )with_statementabsolute_importunicode_literalsN)localesget_icu load_locale) pdtContextpdtContextStack)pdt20DeprecationWarningz Mike Taylorz bear@bear.imzCopyright (c) 2020 Mike TaylorzApache License 2.0z2.6z%https://github.com/bear/parsedatetimez*https://pypi.python.org/pypi/parsedatetimez$Parse human-readable date/time text.) NullHandlerc@seZdZddZdS)r cCsdSN)selfrecordrrC/opt/certbot/lib/python3.10/site-packages/parsedatetime/__init__.pyemit=szNullHandler.emitN)__name__ __module__ __qualname__rrrrrr ;s r FcCsg|]}|t|fqSr)r).0xrrr Esrc Cs\t|d}|dkrdttddt|}|dkr!dS|d}|rt|}|dd}|dd}d}||krt|||ddddddf }t|d }t||}||krm||krf||}n|d}d }n||kr||d kr|||}n|d}||ks>|||fS|d }d}|durd}nt|}|d }|rt|}nd}|||fS)Nyeardrirrrjulianrmonthday)intgrouptimegmtimemktimeabs)mrrr!r"jdaytdiffrrr _extract_dateLsH             r-cCsn|sdS|d}|s dSt|}t|d}|d}|r0|ddddd}t|}nd}|||fS) Nrhoursminutesseconds,.rr)r$r#replacesplit)r)r.r/r0rrr _extract_timezs    r5cCsR|sdS|dr||j|dr||j|dr'||jdSdS)Nr.r/r0)r$updateAccuracyACU_HOURACU_MINACU_SEC)r)ctxrrr_pop_time_accuracys     r;cs>dd}fdd}d}d}d|}d||f}t||S) NcSsv|sdS|d}|s dS|dkrdSt|d}|d}|r&t|}nd}|d|d}|ddkr9| S|S)zAReturn the Time Zone Designator as an offset in seconds from UTC.rtzdZtzdhours tzdminutes<+)r$r#)r)r<r.r/offsetrrr __extract_tzds     z1__closure_parse_date_w3dtf..__extract_tzdcs6|}|dus||krdSt|t|dS)Nr)matchr$r-r5) dateStringr) __datetime_rxrr_parse_date_w3dtfs z5__closure_parse_date_w3dtf.._parse_date_w3dtfzd(?P\d\d\d\d)(?:(?P-|)(?:(?P\d\d\d)|(?P\d\d)(?:(?P=dsep)(?P\d\d))?))?z;(?P[-+](?P\d\d)(?::?(?P\d\d))|Z)zW(?P\d\d)(?P:|)(?P\d\d)(?:(?P=tsep)(?P\d\d(?:[.,]\d+)?))?z %s(?:T%s)?)recompile)rCrH __date_re__tzd_re __time_re __datetime_rerrFr__closure_parse_date_w3dtfs   rO)janfebmaraprmayjunjulaugsepoctnovdecjanuaryfebruarymarchaprilrTjunejulyaugust septemberoctobernovemberdecember)montuewedthufrisatsuncCs|}|dddvs|dtvr|d=t|dkr>|d}|dd}t|dkr4||dd <n|d d |}t|d krH|d 7}tj|S)z8Parse an RFC822, RFC1123, RFC2822, or asctime-style dater)r1r2rArN z 00:00:00 GMT) r4lower _daynameslenappendjoinemailutils parsedate_tz)rEdatasrrr_parse_date_rfc822s        rrqc@sReZdZdZdefddZejddZe ddZ d d Z d d Z dKd dZ dKddZdKddZddZddZddZddZddZddZdd Zd!d"Zd#d$Zd%d&Zd'd(Zd)d*Zd+d,Zd-d.Zd/d0Zd1d2Zd3d4Z d5d6Z!d7d8Z"d9d:Z#d;d<Z$d=d>Z%d?d@Z&dAdBZ'  dLdCdDZ(dMdEdFZ)dMdGdHZ*dMdIdJZ+dS)NCalendarz A collection of routines to input, parse and manipulate date and times. The text can either be 'normal' date values or it can be human readable. NcCs>|dur t|_n||_||_|tkrtdtt|_dS)a Default constructor for the L{Calendar} class. @type constants: object @param constants: Instance of the class L{Constants} @type version: integer @param version: Default style version of current Calendar instance. Valid value can be 1 (L{VERSION_FLAG_STYLE}) or 2 (L{VERSION_CONTEXT_STYLE}). See L{parse()}. @rtype: object @return: L{Calendar} instance NzFlag style will be deprecated in parsedatetime 2.0. Instead use the context style by instantiating `Calendar()` with argument `version=parsedatetime.VERSION_CONTEXT_STYLE`.) ConstantsptcversionVERSION_FLAG_STYLEwarningswarnr r _ctxStack)r constantsrrrr__init__s  zCalendar.__init__ccsBt}|j||V|j}|js|j|dSdSr )r rpushpopisEmptycurrentContextupdate)rr:rrrcontexts   zCalendar.contextcCs |jSr )rlast)rrrrr$s zCalendar.currentContextcCstd|dd}}}|D];}|jj|}|dur ||7}q|dkr)|d9}q|jj|}|dur=|||7}d}q||jjvrDqtd|||S)z Converts text units into their number value. @type unitText: string @param unitText: number text to convert @rtype: integer @return: numerical value of unitText z[,\s-]+rNhundredrzUnknown number: )rIr4rsmallget magnitudeignore Exception)runitText word_listabwordrrrr_convertUnitAsWords(s      zCalendar._convertUnitAsWordsc Csb|j}to td||||durt}|durd}n|}||}||jjvr=||jj|}|dus;|dkr=d}|\ }}} } } } } } } t ||| | | | }|}|}|jj D] \}}||vrh|}nq\tortd|||z(|dvr|j |fi|dd|i}n|dvrt j d i||i}||}Wn tyY|Sw|||S) a Take C{quantity}, C{modifier} and C{unit} strings and convert them into values. After converting, calcuate the time and return the adjusted sourceTime. @type source: time @param source: time to use as the base (or source) @type quantity: string @param quantity: quantity string @type modifier: string @param modifier: how quantity and units modify the source time @type units: string @param units: unit of the quantity (i.e. hours, days, months, etc) @rtype: struct_time @return: C{struct_time} of the calculated time z_buildTime: [%s][%s][%s]Nrrdyz!units %s --> realunit %s (qty=%s))yearsmonthsrn)daysr.r/r0weeksr)rdebuglogr% localtimestrip_quantityToRealr Modifiersdatetimeunitsitemsinc timedelta OverflowErrorr6 timetuple)rsourcequantitymodifierrr:qtyyrmthrhrmnsec_starttargetrealunitkeyvaluesdeltarrr _buildTimeDsR       zCalendar._buildTimec Cs|durt\ }}}}}}} } } n |\ }}}}}}} } } d} d} d}g}|}|jj|}|durF|}t|d|} ||dd}|jj|}|durh|}t|d|} t||dd}nt|} | | |g}|||d}| dkr|jjngd}t ddD] }||}||}|dkr|||<| t j t j t jd|q|dkr||d ks||d kr||d kr|d |jj}n|d }|d }|d }||jjkr|d 7}n|d kr|d7}|j||}totd|||||:}|dkr%|dkr%|dkr%||kr%||||||| | | f }|j|n t}Wd|SWd|S1s=wY|S)a Parse short-form date strings:: '05/28/2006' or '04.21' @type dateString: string @param dateString: text to convert to a C{datetime} @type sourceTime: struct_time @param sourceTime: C{struct_time} value to use as the base @rtype: struct_time @return: calculated C{struct_time} value of dateString Nrnr)r)dyr)rr)rrrpr)rrrlzparseDate: %s %s %s %s )r%rr CRE_DATE2searchrr#rdp_orderrangerxr ACU_MONTHACU_DAYACU_YEARYearParseStyle BirthdayEpoch daysInMonthrrrr6)rrE sourceTimerrrrrrwdydisdstv1v2v3accuracyr~r)indexvrrincdaysInCurrentMonthr:rrr parseDates|   ,           zCalendar.parseDatec Cs|durt\ }}}}}}} } } n |\ }}}}}}} } } |} |} g}to+td|||}|jj|}|d}|jj |}| d|ddur[t |d}| dnd}|ddurt |d}| d||jj kr{|d7}n|d kr|d 7}n|| ks|| kr|| kr||jj 7}|*}|d kr||j||kr||||||| | | f }|j|nt}Wdn1swYtotd |||||S|S) a Parse long-form date strings:: 'May 31st, 2006' 'Jan 1st' 'July 2006' @type dateString: string @param dateString: text to convert to a datetime @type sourceTime: struct_time @param sourceTime: C{struct_time} value to use as the base @rtype: struct_time @return: calculated C{struct_time} value of dateString Nz(parseDateText currentMth %s currentDy %smthnamer!r"rrrrrrz7parseDateText returned mth %d dy %d yr %d sourceTime %s)r%rrrrur CRE_DATE3rr$ MonthOffsetsrxr#rrrrr6)rrErrrrrrrrrr currentMth currentDyrr~r)r:rrr parseDateTextsT            zCalendar.parseDateTextcCsd}}d}}|}|jj|vr&||jjd|jj}|dd}|jjdf|jjdf|jjdf|jjd f|jj d f|jj d f|jj d ffD]\}} | |} | d ur\| }nqKt oet d||| d ur| |kr| } |d | } || d } d| | f}|||t\}}|jsd }n|} |dvrt |jj| } | d | }| | dd }d}n|dvrt |jj| } |jjrt |jjd| }|d ur| d | |jjd}n| d | |jjd}n| d | }| | dd }d}n|d kr0t |jj| } | d | }| | dd }d}n|d krt |jj| } | | dd }|jj |}|d}|d urz| d | }|jj |}|d}|d ury|d|}n| d | }d}n6|d krt |jj| } | d | }|jj |}|d}|| | dd }d}nt}}|r|||t\}}|||t\}}|jr|jsd}|||fS)a Evaluate the C{datetimeString} text and determine if it represents a date or time range. @type datetimeString: string @param datetimeString: datetime text to evaluate @type sourceTime: struct_time @param sourceTime: C{struct_time} value to use as the base @rtype: tuple @return: tuple of: start datetime, end datetime and the invalid flag rrrz %s z rsrrqrprortNzevalRanges: rangeFlag = %s [%s]%s %s)rrq)rprrz, r)rrurrangeSepr3 CRE_TIMERNG1 CRE_TIMERNG2 CRE_TIMERNG4 CRE_TIMERNG3 CRE_DATERNG1 CRE_DATERNG2 CRE_DATERNG3rrrr$rendparseVERSION_CONTEXT_STYLE hasDateOrTimerI usesMeridianammeridianrr%r)rdatetimeStringr rangeFlagretFlagstartStrendStrr~crerflagr)parseStrchunk1chunk2r:ampmdateendYear startYearrstartDTendDTsctxectxrrr evalRanges's                          zCalendar.evalRangesc Cs||}|}|dkr$||||ks|r||krd}n |dvr"|}nd}|d|}|dkr7|dkr7|d7}n |dkrC|dkrC|d8}toQtd||||||S|S) aO Based on the C{style} and C{currentDayStyle} determine what day-of-week value is to be returned. @type wd: integer @param wd: day-of-week value for the current day @type wkdy: integer @param wkdy: day-of-week value for the parsed day @type offset: integer @param offset: offset direction for any modifiers (-1, 0, 1) @type style: integer @param style: normally the value set in C{Constants.DOWParseStyle} @type currentDayStyle: integer @param currentDayStyle: normally the value set in C{Constants.CurrentDOWParseStyle} @rtype: integer @return: calculated day-of-week rqr)rnrrrirnz7wd %s, wkdy %s, offset %d, style %d, currentDayStyle %d)rr) rrwkdyrBstylecurrentDayStylediffBase origOffsetr,rrr_CalculateDOWDeltas.    zCalendar._CalculateDOWDeltacCsV|sdSz t|ddWStyYnwz t|jj|WSty*YdSw)z Convert a quantity, either spelled-out or numeric, to a float @type quantity: string @param quantity: quantity to parse to float @rtype: int @return: the quantity as an float, defaulting to 0.0 g?r1r2)floatr3 ValueErrorrnumbersKeyError)rrrrrrs   zCalendar._quantityToRealc$ Cs|j}|jj|}|dur|\ }}} } } } } }}n t\ }}} } } } } }}|jjr1| }| }| }n|jj}d}d}|jj|}|durY| d}|d| }||d}n|}d}t ogt d||||||jj dvr|j ||}|dkr|} ||| |||| ||f }n<|dkr| |kr|j |d|} t||| |||}|j|dd}|}nt||d|||}|j||d}|}||jnX||jj d vr/|dkrt||| d dd}|tjd | d }|}n4|dkrt||| |||}|tjd d }|}nt||| |||}||tjdd}|}||jn||jj dvr|dkrO||| d dd| ||f }||jn2|dkrkt||| | | | }|tjdd }|}nt||| |||}|tj|d }|}||jn||jj dvr|dkr||| | dd| ||f }nt||| | dd}|tj|d}|}||jnd||jj dvr|dkr|dd| | | | ||f }n |dkr|d|| | | | | ||f }n ||dd|||| ||f }||jn"|dkr"|j ||} ||| |||| ||f }||jn|dkrCd}|j ||} ||| |||| ||f }||jn|jj|r|jj|}t oYt d|}|dkr||j|||t\}}|j||}|dur|}||jne|}|dv}|rd}|jj|}| | |||jj!|jj"}t||| |||}|tj|d }|dkr|r|||t\}}|j#rt$|t$|} |tj|d tj| |d}d}|}||jn1|dkr>|dkr>|jj%|r>|jj%|}t ot d||dt\\ }}} } } } } }}}t||| | | | }|tj|d }|}nt oGt d|||&}|rd||f}!||!|t\}}|j'r|(}"|"|jj)vst|"|jj*vr|\ }}} } } } } }}t||| | | | }|j||d}n|"|jj+vr|tj|d}|j#r|}d}|&}|rz t,|jj-.|d}Wn t/yYn'wd}#t ot d |0||}#d!|d| |#||1df}|||t\}}d}|j#r|}t ot d"||j||}|dur%t ot d#|}||jt o8t d$|||d||f|fSd||f|fS)%a Evaluate the C{modifier} string and following text (passed in as C{chunk1} and C{chunk2}) and if they match any known modifiers calculate the delta and apply it to C{sourceTime}. @type modifier: string @param modifier: modifier text to apply to sourceTime @type chunk1: string @param chunk1: text chunk that preceded modifier (if any) @type chunk2: string @param chunk2: text chunk that followed modifier (if any) @type sourceTime: struct_time @param sourceTime: C{struct_time} value to use as the base @rtype: tuple @return: tuple of: remaining text and the modified sourceTime Nrrrrz/modifier [%s] chunk1 [%s] chunk2 [%s] unit [%s]rrq)r!rrorr)rrr.)r.rrreomeoyzCRE_WEEKDAY matchedeod)thisnextrpriorprevious)r0zCRE_TIME matchedz0check for modifications to source time [%s] [%s]r)rrnzCRE_NUMBER matchedz%s%s%szlooking for modifier %szmodifier found in sourcesz-returning chunk = "%s %s" and sourceTime = %s)2rrrr%rStartTimeFromSourceTime StartHour CRE_REMAININGrrrrrrrrrr6rrACU_WEEK ACU_HALFDAYrr7r CRE_WEEKDAYrDr$rr getSourceWeekdayOffsetsr DOWParseStyleCurrentDOWParseStylerr'CRE_TIMErhasDateruMonths shortMonthsWeekdayslist CRE_NUMBERfinditer IndexErrorrr)$rrrrrr:rBrrrrrrrrr startHour startMinute startSecondr)runitcurrentDaysInMonthrrr subctxsTime dowOffsetrelativeModifierr,r+rr~urrrr _evalModifiers                               $         zCalendar._evalModifierc Cs|j}|}|durTt|}totdt||durT|\ }}}}} } } } } }||j|j|j |dkrI| dkrI| dkrI||j |j |j ||||| | | | | f }|durpt |}|durp||j|j|j |j |j |j |durxt}|S)a} Calculate the datetime from known format like RFC822 or W3CDTF Examples handled:: RFC822, W3CDTF formatted dates HH:MM[:SS][ am/pm] MM/DD/YYYY DD MMMM YYYY @type datetimeString: string @param datetimeString: text to try and parse as more "traditional" date/time text @type sourceTime: struct_time @param sourceTime: C{struct_time} value to use as the base @rtype: datetime @return: calculated C{struct_time} value or current C{struct_time} if not parsed Nzattempt to parse as rfc822 - %sr)rrrrrstrr6rrrr7r8r9rHr%r)rrrr:r~rrrrrrrrrrrrr_evalDTs. zCalendar._evalDTcC^|}|||}d}|jj|}|dur%|d}|d|d}|||||}|S)zA Evaluate text passed by L{_partialParseUnits()} rrNr)rr<r CRE_UNITSrr$rrrrrr~rr)rrrrr _evalUnits+  zCalendar._evalUnitscCr=)zB Evaluate text passed by L{_partialParseQUnits()} rrNqunits)rr<r CRE_QUNITSrr$rrr?rrr _evalQUnits=rAzCalendar._evalQUnitscCs<|}|||}totd|||S|||S)zC Evaluate text passed by L{_partialParseDateStr()} zchecking for MMM DD YYYY)rr<rrrrrrr~rrr _evalDateStrOs    zCalendar._evalDateStrcCs |}|||}|||S)zC Evaluate text passed by L{_partialParseDateStd()} )rr<rrErrr _evalDateStdZs  zCalendar._evalDateStdc Cs|}|||}|\ }}}}}} } } } z|jj|} Wn ty(d} Ynw|jjr4|}|}| }n|jj}d}d}|jt j t ||||||}|t j | d}| S)zB Evaluate text passed by L{_partialParseDaystr()} rr)rr<r dayOffsetsrrrrr6r rrrr)rrrr~rrrrrrrrrrBr0r1r2rrrrr _evalDayStrds*   zCalendar._evalDayStrc Cs|}|||}|\ }}}}}} } } } t|||||| } |jj|}|| kr7|| |d|jj|jj}n || |d|jj|jj}|j t j | tj |d}| S)zC Evaluate text passed by L{_partialParseWeekday()} rqr)rr<rrr$rr%r&rr6r rrr)rrrr~rrrrrrrrrrr rrrrr _evalWeekdays"    zCalendar._evalWeekdaycCs^|}|||}||jjdvr|jtj|S|j||}|r&|}|jtj |S)zC Evaluate text passed by L{_partialParseTimeStr()} now) rr<r re_valuesrr6r ACU_NOWr#r!)rrrr~r6rrr _evalTimeStrs  zCalendar._evalTimeStrc Cs|}|||}|\ }}}}}} } } } |jj|} | durh|d| d}t|dkr:t|}d}d} nt| \}}} |dkrGd}| d }||jj vrZ|dkrZd}||jj vrh|dkrh|d7}|dkr|dkr| dkr|||||| | | | f }t | |j|S)zD Evaluate text passed by L{_partialParseMeridian()} Nrrqrrr@)rr<r CRE_TIMEHMS2rrrwr#r5r$rurpmr;r)rrrr~rrrrrrrrrr)dtrrrr _evalMeridians,   zCalendar._evalMeridianc Cs|}|||}|\ }}}}}} } } } |jj|} | dur't| \}}} |dkr-d}|dkrJ|dkrJ| dkrJ|||||| | | | f }t| |j|S)zC Evaluate text passed by L{_partialParseTimeStd()} NrOrr@)rr<r CRE_TIMEHMSrr5r;r)rrrr~rrrrrrrrrr)rrr _evalTimeStds  zCalendar._evalTimeStdcCsp|jj|}|dur6d|d||f}|||dkr4|d|dkr4|d|kr4dSdSdS)Nz%s%sr"suffixrTF)rCRE_DAY2rr$r)rr~r)rm2r+rrr _UnitsTrappeds  zCalendar._UnitsTrappedcCsd}d}}|jj|}|dur2||kr0|}|d|}||d}n|}|rHto=td|||| ||||\}}||t |fS)a test if giving C{s} matched CRE_MODIFIER, used by L{parse()} @type s: string @param s: date/time text to evaluate @type sourceTime: struct_time @param sourceTime: C{struct_time} value to use as the base @rtype: tuple @return: tuple of remained date/time text, datetime object and an boolean value to describ if matched or not Nrrzfound (modifier) [%s][%s][%s]) r CRE_MODIFIERrr$rrrrrr:boolrr~rrrrr)rrr_partialParseModifiers$  zCalendar._partialParseModifiercCd}d}}|jj|}|durftotd|||dr'to%tdn?|d|krb|d}|d|d}|| dd}|dddkr[d |}|dd}d ||f}n|}d}|rxtoqtd |||| ||}||t |fS) a test if giving C{s} matched CRE_UNITS, used by L{parse()} @type s: string @param s: date/time text to evaluate @type sourceTime: struct_time @param sourceTime: C{struct_time} value to use as the base @rtype: tuple @return: tuple of remained date/time text, datetime object and an boolean value to describ if matched or not NrrCRE_UNITS matchedr day suffix trapped by unit matchrrn--%srzfound (units) [%s][%s][%s]) rr>rrrrYr$rrrr@r[r\rrr_partialParseUnits's4      zCalendar._partialParseUnitscCr^) a test if giving C{s} matched CRE_QUNITS, used by L{parse()} @type s: string @param s: date/time text to evaluate @type sourceTime: struct_time @param sourceTime: C{struct_time} value to use as the base @rtype: tuple @return: tuple of remained date/time text, datetime object and an boolean value to describ if matched or not NrrCRE_QUNITS matchedrB!day suffix trapped by qunit matchrrnrarbrzfound (qunits) [%s][%s][%s]) rrCrrrrYr$rrrrDr[r\rrr_partialParseQUnitsUs8     zCalendar._partialParseQUnitsc Cs$d}d}}|jj|}|dury|d|kru|d}|d}d} |jj|} |d} | dur;| dur;d} n|jj|} | durL| durLd} | r\| d} | |dkr\| }|||}|d|}||d}d||f}n|}d}|rtot d |||| ||}||t |fS) a test if giving C{s} matched CRE_DATE3, used by L{parse()} @type s: string @param s: date/time text to evaluate @type sourceTime: struct_time @param sourceTime: C{struct_time} value to use as the base @rtype: tuple @return: tuple of remained date/time text, datetime object and an boolean value to describ if matched or not NrrrFrTr.rzfound (date3) [%s][%s][%s]) rrrr$rrrPrTrrrFr[) rr~rrrrr)mStartmEndfTimemmmYear hoursStartrrr_partialParseDateStrs@         zCalendar._partialParseDateStrcCsd}d}}|jj|}|dur:|d|kr6|d}|d|d}||dd}d||f}n|}d}|rLtoEtd||||||}||t |fS)a test if giving C{s} matched CRE_DATE, used by L{parse()} @type s: string @param s: date/time text to evaluate @type sourceTime: struct_time @param sourceTime: C{struct_time} value to use as the base @rtype: tuple @return: tuple of remained date/time text, datetime object and an boolean value to describ if matched or not Nrrrrzfound (date) [%s][%s][%s]) rCRE_DATErr$rrrrrGr[r\rrr_partialParseDateStds$  zCalendar._partialParseDateStdcCsd}d}}|jj|}|dur6||kr2|}|d|}||d}d||f}n|}d}|rHtoAtd||||||}||t |fS)a test if giving C{s} matched CRE_DAY, used by L{parse()} @type s: string @param s: date/time text to evaluate @type sourceTime: struct_time @param sourceTime: C{struct_time} value to use as the base @rtype: tuple @return: tuple of remained date/time text, datetime object and an boolean value to describ if matched or not Nrrrzfound (day) [%s][%s][%s]) rCRE_DAYrr$rrrrrIr[r\rrr_partialParseDayStrs$  zCalendar._partialParseDayStrc Csd}d}}|j}td||j|j|jj|}|durI|}||jj vrI||krE|}|d| }|| d}d||f}n|}d}|r^|js^toWtd|||| ||}||t |fS)a test if giving C{s} matched CRE_WEEKDAY, used by L{parse()} @type s: string @param s: date/time text to evaluate @type sourceTime: struct_time @param sourceTime: C{struct_time} value to use as the base @rtype: tuple @return: tuple of remained date/time text, datetime object and an boolean value to describ if matched or not Nrrzeval %s with context - %s, %srzfound (weekday) [%s][%s][%s])rrrr(hasTimerr"rr$rHrrrJr[) rr~rrrrr:r)gvrrr_partialParseWeekdays,   zCalendar._partialParseWeekdaycCsd}d}}|jj|}|dus||jjdvr@|r<||kr<|}|d|}||d}d||f}n|}d}|rRtoKtd|||| ||}||t |fS)a test if giving C{s} matched CRE_TIME, used by L{parse()} @type s: string @param s: date/time text to evaluate @type sourceTime: struct_time @param sourceTime: C{struct_time} value to use as the base @rtype: tuple @return: tuple of remained date/time text, datetime object and an boolean value to describ if matched or not NrrrKrzfound (time) [%s][%s][%s]) rr'rrLr$rrrrrNr[r\rrr_partialParseTimeStrEs$ zCalendar._partialParseTimeStrcCsd}d}}|jj|}|dura|ddur=|ddur0d|d|d|df}nd|d|df}n|d}|d|d 7}|d|}||d}d ||f}|rstoltd ||||||}||t |fS) a test if giving C{s} matched CRE_TIMEHMS2, used by L{parse()} @type s: string @param s: date/time text to evaluate @type sourceTime: struct_time @param sourceTime: C{struct_time} value to use as the base @rtype: tuple @return: tuple of remained date/time text, datetime object and an boolean value to describ if matched or not Nrrr/r0%s:%s:%sr.%s:%srsrrzfound (meridian) [%s][%s][%s]) rrPrr$rrrrrSr[r\rrr_partialParseMeridianks2      zCalendar._partialParseMeridiancCsd}d}}|jj|}|dur_|ddur;d|d|d|df}|d|d}||dd}nd|d|df}|d|d}||dd}d||f}|rqtojtd ||||||}||t |fS) a test if giving C{s} matched CRE_TIMEHMS, used by L{parse()} @type s: string @param s: date/time text to evaluate @type sourceTime: struct_time @param sourceTime: C{struct_time} value to use as the base @rtype: tuple @return: tuple of remained date/time text, datetime object and an boolean value to describ if matched or not Nrrr0rvr.r/rwrzfound (hms) [%s][%s][%s]) rrTrr$rrrrrUr[r\rrr_partialParseTimeStds0    zCalendar._partialParseTimeStdc s\tdfddtdfdd}|j||d\}}|tj|dd}||fS) av C{datetimeString} is as C{.parse}, C{sourceTime} has the same semantic meaning as C{.parse}, but now also accepts datetime objects. C{tzinfo} accepts a tzinfo object. It is advisable to use pytz. @type datetimeString: string @param datetimeString: date/time text to evaluate @type sourceTime: struct_time, datetime, date, time @param sourceTime: time value to use as the base @type tzinfo: tzinfo @param tzinfo: Timezone to apply to generated datetime objs. @type version: integer @param version: style version, default will use L{Calendar} parameter version value @rtype: tuple @return: tuple of: modified C{sourceTime} and the result flag/context see .parse for return code details. rcsSr rr)rrrsz"Calendar.parseDT..localizecs |jdS)Ntzinfo)r3)rRr|rrrzs )rrNr)getattrrr) rrrr}rr{ time_structret_coderRr)rr}rparseDTs  zCalendar.parseDTc Cstotdtdd|}tdd|}tdd|}|r@t|tjr0to*td|}nt|tjs?t|t s?t dnt }| m}| }toVtd ||r|j|j|j|j|j|j|j|j|j|jf D]}|||\}}} | r||}}nqod }totd |j|jtotd ||sY|d urtotdt|t }Wd n1swYt|tjst|}|d ur|jn|}|tkr||fS||jfS)ag Splits the given C{datetimeString} into tokens, finds the regex patterns that match and then calculates a C{struct_time} value from the chunks. If C{sourceTime} is given then the C{struct_time} value will be calculated from that value, otherwise from the current date/time. If the C{datetimeString} is parsed and date/time value found, then:: If C{version} equals to L{VERSION_FLAG_STYLE}, the second item of the returned tuple will be a flag to let you know what kind of C{struct_time} value is being returned:: 0 = not parsed at all 1 = parsed as a C{date} 2 = parsed as a C{time} 3 = parsed as a C{datetime} If C{version} equals to L{VERSION_CONTEXT_STYLE}, the second value will be an instance of L{pdtContext} @type datetimeString: string @param datetimeString: date/time text to evaluate @type sourceTime: struct_time @param sourceTime: C{struct_time} value to use as the base @type version: integer @param version: style version, default will use L{Calendar} parameter version value @rtype: tuple @return: tuple of: modified C{sourceTime} and the result flag/context zparse()z (\w)\.(\s)z\1\2z(\w)[\'"](\s|$)z\1 \2z(\s|^)[\'"](\w)zcoercing datetime to timetuplezsourceTime is not a struct_timez%remainedString (before parsing): [%s]rrzhasDate: [%s], hasTime: [%s]zremainedString: [%s]Nznot parsed [%s])rrrIsub isinstancerrr% struct_timetuplerrrrurr]rcrfrmrorqrtrurxryr(rrr;rr dateTimeFlag) rrrrr:r~ parseMethretSretTimematchedrrrrsr "          zCalendar.parsec Csj|j}|j}|j}zt|}Wn ttfyd}Ynwzzt|}Wn ttfy1d}YnwW||d7}d}n ||d7}d}wd}d}|rt|} || }t| d} | | d} || }|dkrp| d8} |d7}n |dkr|| d7} |d8}|| 7}|j||}||kr|}|t j ks|t j krt d|j |||d} |r| t j||d7} || |S) a Takes the given C{source} date, or current date if none is passed, and increments it according to the values passed in by month and/or year. This routine is needed because Python's C{timedelta()} function does not allow for month or year increments. @type source: struct_time @param source: C{struct_time} value to increment @type month: float or integer @param month: optional number of months to increment @type year: float or integer @param year: optional number of years to increment @rtype: datetime @return: C{source} incremented by the number of months and/or years rrrg(@rzyear is out of range)rr!r"r)rr!r"r TypeErrorrr#rrrMAXYEARMINYEARrr3r) rrr!rrrrsubMimaxDaymirr)rrrrrNsT        z Calendar.incc Cs |}tdd|}tdd|}tdd|}d}g}|t|krgd}|jj||d}|dure|ddksG|d||kre|||d<|||d<| |d <d|d <d |d <|jj ||d}|durt ozt d | ||d|drt ot dnT|ddks|d|d|kr|d||d<|d||d<| d|d <d |d <d|d <|ddkr||dddkr|dd|d<d|d |d <|jj||d}|durft ot d| ||d|drt o t dnX|ddks!|d|d|krf|d||d<|d||d<| d|d <d |d <d|d <|ddkrf||dddkrf|dd|d<d|d |d <|jj||d}|dur|ddks|d|d|kr|d||d<|d||d<| d|d <d|d <d|d <|jj||d}|dur|ddks|d|d|kr|d||d<|d||d<| d|d <d|d <d|d <|jj||d}|dur.|ddks|d||kr.|||d<|||d<| |d <d|d <d|d <|jj||d}|dury||d|jjvry|ddks[|d||kry|||d<|||d<| |d <d|d <d|d <|jj||d}|dur|ddks|d||kr|||d<|||d<| |d <d |d <d|d <|jj||d}|dur|ddks|d|d|kr|d||d<|d||d<||d|d|d <d |d <d|d <|jj||d}|dur]|ddks%|d|d|kr]|d||d<| ddur@|d||d<n |d||d<||d|d|d <d |d <d|d <t|dkr|d d dkr|jj||d}|dur||||d!krt ot d"| |ddks|d||kr|||d<|||d<| |d <d |d <d#|d <|d}|dkrt|}n9|d dkr |jj|d|dd$t|d }|dur |d%|d<||d|d|d <|||t|ks$g} t|dkrd!} d} |dd dk} |dd d k} |dd d k}tdt|D]}||dd}||d}|||d!kr| sf| sf|r||| d||dd} || ||\}}| tj|dd&||| d||dd| f|} ||d dk} ||d d k} ||d d k}q@||d dkrd'} ||d d krd'} ||d d krd'}q@| s| s|r||| d|t|dd} || ||\}}| tj|dd&||| d|t|dd| ft| St|dkr'dS|dd dkr2dS||dd|dd} ||dd ||\}}| tj|dd&||dd|dd| ft| S)(aUtilizes parse() after making judgements about what datetime information belongs together. It makes logical groupings based on proximity and returns a parsed datetime for each matched grouping of datetime text, along with location info within the given inputString. @type inputString: string @param inputString: natural language text to evaluate @type sourceTime: struct_time @param sourceTime: C{struct_time} value to use as the base @type version: integer @param version: style version, default will use L{Calendar} parameter version value @rtype: tuple or None @return: tuple of tuples in the format (parsed_datetime as datetime.datetime, flags as int, start_pos as int, end_pos as int, matched_text as string) or None if there were no matches z (\w)(\.)(\s)z\1 \3z(\w)(\'|")(\s|$)z(\s|^)(\'|")(\w)r)rrNrNNrrqrprror_rr`rrardrBrerdateStrdateStddayStrweekdytimeStrr.rr0r/timeStdrnrrzCRE_UNITS_ONLY matched [%s] unitsOnlyrs nlp_prefixrT) rIrrurwrrZrrrr$r>rrrYrCrrnrpr"rHr'rPrTCRE_UNITS_ONLYrCRE_NLP_PREFIXr;rxrrrr)r inputStringrrorig_inputstringstartposmatchesleftmost_matchr)proximity_matchescombinedfrom_match_indexrr%rr endofprevious begofcurrentparsed_datetimeflagsrrrnlps                            =       z Calendar.nlpr )NNN)NN),rrr__doc__rr contextlibcontextmanagerrpropertyrrrrrrrrr:r<r@rDrFrGrIrJrNrSrUrYr]rcrfrmrorqrtrurxryrrrrrrrrrsZ   E Y E53  ($./J&&+&-* 0 \Erc Csddg|_ddg|_t|jjddD]0\}}ddg|}t|||gt||}|rD|}||ddj |||ddj |fqdS)z< Initialize symbols and single character constants. rrNrqrrQrz{0}.{1}.) rrQ enumeratelocalersetattrr~ruextendformat)ridxxmrlxmrrr _initSymbolss    rc@s<eZdZdZdddgfddZddZd d Zd d d ZdS)raC Default set of constants for parsedatetime. If PyICU is present, then the class will first try to get PyICU to return a locale specified by C{localeID}. If either C{localeID} is None or if the locale does not exist within PyICU, then each of the locales defined in C{fallbackLocales} is tried in order. If PyICU is not present or none of the specified locales can be used, then the class will initialize itself to the en_US locale. if PyICU is not present or not requested, only the locales defined by C{pdtLocales} will be searched. NTen_UScCs||_|dd|_d|jvr|jdd|_||_ttddd|_d|_d|_ d|_ d|_ d |_ d |_ d |_d |_d |_d|_d|_d|_d|_d|_d|_|jrft|j|_|jjdurfd|_d|_|jdur|jtvrtdt|jD]}|j||_|jtvrnqxt|j|_|jdur[dd}dd}||jj}||jj}||jj} ||jj} |||jjd<|||jjd<|| |jjd<|| |jjd<||jj |jjd<||jj!|jjd<t"#|jj$|jjd<dd|jj%&D} | j'tdd || |jjd!<||jj(|jjd"<||jj)|jjd#<||jj*|jj+|jjd$<d%d&} | |jj,|jjd| |jj,|jjd| |jj-|jjd| |jj-|jjdt.|d'j/d\i|jj|_0d(j/d\i|jj|_1d)j/d\i|jj|_2d*j/d\i|jj|_3d+j/d\i|jj|_4d,j/d\i|jj|_5d-j/d\i|jj|_6d.j/d\i|jj|_7d/j/d\i|jj|_8d0j/d\i|jj|_9d1j/d\i|jj|_:d2j/d\i|jj|_;d3|_d d:gD} d;/| |_?dj/d\i|jj|_Bd?j/d\i|jj|_Cd@|_DdAj/d\i|jj|_EdBj/d\i|jj|_Fd4|jjvry|jFdCj/d\i|jj7_FdD| |_GdEj/d\i|jj|_HdFj/|jGfi|jj|_IdFj/|jHfi|jj|_JdGj/|jHfi|jj|_KdFj/|jFfi|jj|_LdFj/|jEfi|jj|_MdHj/|jFfi|jj|_NdIj/|jE|jFfi|jj|_Ot"jPt"jQ|_RidJ|j5dK|j4dL|j7dM|j6dN|j8dO|j9dP|j:dQ|j;dR|j?dS|j@dT|j1dU|j0dV|j2dW|j3dX|jAdY|jBdZ|jC|jD|jE|jF|jG|jH|jL|jM|jN|jO|jI|jJ|jK|j._getLocaleDataAdjustedcSsddd|DS)Nrcs|]}t|VqdSr rIescape)rrrrr l sz6Constants.__init__..re_join..)ry)grrrre_joink sz#Constants.__init__..re_joinr shortmonthsr shortdays dayoffsetsr decimal_markcSsg|] }|D]}|qqSrr)rrr3rrrr s  z&Constants.__init__..T)rreverser modifierssourcestimecomponentscSsD|}|D]}d|vr|dD]}|||<qn|||<|d7}qdS)Nrr)r4) offsetDictr indexStartorkrrr _buildOffsets s  z)Constants.__init__.._buildOffsetsa(?P ( ( (?P\d\d?) (?P{daysuffix})? (,)? (\s)* ) (?P \b({months}|{shortmonths})\b )\s* (?P\d\d (\d\d)? )? ) )aM(?P (?: (?:^|\s+) (?P {months}|{shortmonths} )\b | (?:^|\s+) (?P[1-9]|[012]\d|3[01]) (?P{daysuffix}|)\b (?!\s*(?:{timecomponents})) | ,?\s+ (?P\d\d(?:\d\d|))\b (?!\s*(?:{timecomponents})) ){{1,3}} (?(mthname)|$-^) )a(\s+|^) (?P ( (?P \b({months}|{shortmonths})\b ) (\s* (?P(\d{{4}})) )? ) ) (?=\s+|$|[^\w])z\b (?: {days}|{shortdays} ) \bz-(\b(?:{numbers})\b|\d+(?:{decimal_mark}\d+|))z(?P^[{specials}]+)\s+z \b({units})\bz\b(?P -? (?:\d+(?:{decimal_mark}\d+|)|(?:{numbers})\b)\s* (?P{units}) )\bz\b(?P -? (?:\d+(?:{decimal_mark}\d+|)|(?:{numbers})\s+)\s* (?P{qunits}) )\bzW\b(?: {modifiers} )\ba([\s(\["'-]|^) (?P\d\d?) (?P{timeseparator}|) (?P\d\d) (?:(?P=tsep) (?P\d\d (?:[\.,]\d+)? ) )?\ba([\s(\["'-]|^) (?P\d\d?) (?: (?P{timeseparator}|) (?P\d\d?) (?:(?P=tsep) (?P\d\d? (?:[\.,]\d+)? ) )? )?ao\b(?P (on) (\s)+1 | (at|in) (\s)+2 | (in) (\s)+3 )rz\s*(?P{meridian})\bz\brrcsrr r)rr~rrrr- sz%Constants.__init__..r2a([\s(\["'-]|^) (?P \d\d?[{0}]\d\d?(?:[{0}]\d\d(?:\d\d)?)? | \d{{4}}[{0}]\d\d?[{0}]\d\d? ) \bz[{0}]z\b (?: {dayoffsets} ) \bzZ(?P\d\d?) (?P{daysuffix})? z\b (?: {sources} ) \bz\s+z(\s*|^) (\d\d?){timeseparator} (\d\d) ({timeseparator}(\d\d))? (\s*|$)z(\s*|^) (\d\d?) ({timeseparator}(\d\d?))? ({timeseparator}(\d\d?))?z\s*({meridian})z(\d+([%s]\d+)+)a( ( ( \b({months})\b )\s* ( (\d\d?) (\s?|{daysuffix}|$)+ )? (,\s*\d{{4}})? ) )z{0}\s*{rangeseparator}\s*{0}z1{0}\s*{rangeseparator}\s*(\d\d?)\s*(rd|st|nd|th)?z\d\d?\s*{rangeseparator}\s*{0}z{0}\s*{rangeseparator}\s*{1} CRE_SPECIALr-r>rrCrZrTrPrnrr CRE_DATE4 CRE_MONTHr"rprWr') r CRE_RTIMEHMS CRE_RTIMEHMS2 CRE_RDATE CRE_RDATE3rrrrrrrrr)WlocaleIDfallbackLocalesrxrusePyICUr,r _leapYearsSecondMinuteHourDayWeekMonthYear_DaysInMonthListrrrrrr%r&ricu pdtLocalesrwr)r* shortWeekdaysr+rLrHrrIrrrrsortr re_sourcestimeSeprr$rrrRE_DATE4RE_DATE3RE_MONTH RE_WEEKDAY RE_NUMBER RE_SPECIAL RE_UNITS_ONLYRE_UNITS RE_QUNITS RE_MODIFIER RE_TIMEHMS RE_TIMEHMS2 RE_NLP_PREFIXrydateSepRE_DATERE_DATE2RE_DAYRE_DAY2RE_TIME RE_REMAINING RE_RTIMEHMS RE_RTIMEHMS2RE_RDATE RE_RDATE3DATERNG1DATERNG2DATERNG3TIMERNG1TIMERNG2TIMERNG3TIMERNG4 IGNORECASEVERBOSE re_option cre_sourcesetkeyscre_keys)rrrrlocaleIdrrmthssmthsswdswdsrrdateSepsrrrrs                                          zConstants.__init__cCsN||jvrt|j||j}t||||S||jjvr#t|j|St |r ) r rIrJr r rr locale_keysr~AttributeError)rnamevaluerrr __getattr__ s    zConstants.__getattr__cCstd}to td|||dkr8|dkr8|j|d}|dkr8||jvr)|d7}|St|r8|j||d7}|S)z Take the given month (1-12) and a given year (4 digit) return the number of days in the month adjusting for leap year as needed NzdaysInMonth(%s, %s)rrrrq)rrrrcalendarisleaprx)rr!rresultrrrr s  zConstants.daysInMonthc Cs||jvrdS|durt\ }}}}}}} } } n |\ }}}}}}} } } ||||||d} |j|} i}| D] \}}| ||||<q8|d|d|d|d|d|d| | | f S) a> GetReturn a date/time tuple based on the giving source key and the corresponding key found in self.re_sources. The current time is used as the default and any specified item found in self.re_sources is inserted into the value and the generated dictionary is returned. N)rrrrrrrrrrrr)rr%rrr)r sourceKeyrrrrrrrrrrdefaultsrrrdefaultrrrr# s  zConstants.getSourcer )rrrrrrrr#rrrrrs C r)9r __future__rrrrIr%loggingrrrr email.utilsrz pdt_localesr_localesrrrr r warnsr __author__ __email__ __copyright__ __license__ __version____url____download_url____description__r ImportErrorHandler getLoggerrr addHandlerrdictrr-r5r;rOrHr  _monthnamesrvrrrobjectrrrrrrrsv    .+  \