<#(iDN8dZddlmZddlmZddlmZddlmZ ddlm Z ddl m Z d Z e rdd lZdd lmZdd lmZgd ZeGddeZdCdZdDdZd d ddEdZ dFdGd%Z dHdId)ZdJd+ZdKdLd/ZdMd0ZdNd7ZdOd9ZdPd;Z dQdRd@Z!dSdBZ"d S)TzYTime humanizing functions. These are largely borrowed from Django's `contrib.humanize`. ) annotations)Enum)total_ordering)_gettext) _ngettext)intcommaFN)Iterable)Any) naturaldate naturalday naturaldelta naturaltime precisedeltac6eZdZdZdZdZdZdZdZdZ dZ dd Z d S)Unitrrotherr returncL|j|jur|j|jkStS)N) __class__valueNotImplemented)selfrs M/var/www/html/auto_sub_bot/venv/lib/python3.11/site-packages/humanize/time.py__lt__z Unit.__lt__)s& >U_ , ,: + +N)rr rr ) __name__ __module__ __qualname__ MICROSECONDS MILLISECONDSSECONDSMINUTESHOURSDAYSMONTHSYEARSr!r"r rrsPLLGG E D F Er"rr dt.datetimec<ddl}|jS)Nr)datetimenow)dts r _nowr4/s  ;??  r"delta dt.timedeltacH|jdkrt}|||zz S|S)zReturn an "absolute" value for a timedelta, always representing a time distance. Args: delta (datetime.timedelta): Input timedelta. Returns: datetime.timedelta: Absolute timedelta. r)daysr4)r5r2s r _abs_timedeltar95s, zA~~ffcEk"" Lr")r2preciserr r2dt.datetime | Noner:booltuple[Any, Any]cLddl}|st}t||jr|}||z }nct||jr||z }|}nF |r|nt |}|j|}||z }n#t t f$rd|fcYSwxYw|t|fS)zTurn a value into a date and a timedelta which represents how long ago it was. If that's not possible, return `(None, value)`. rNseconds)r1r4 isinstance timedeltaint ValueError TypeErrorr9)rr2r:r3dater5s r _date_and_deltarGDs ff%%% e  E2< ( ( U{ $4EE#e**E BL///E;DDI&   ;     && &&s)A::BBTr@dt.timedelta | floatmonths minimum_unitstrc|ddl}t|}|tjtjtjfvrd|d}t ||}t||jr|}nW t|t|}|j|}n&#t tf$rt|cYSwxYw|}t|}|jdz} |jdz} t| dz} | s| dkr|jdkr|tjkr)|jd krt#d d |j|jzS|tjks%|tjkr@d |jcxkrd kr.nn+|jd z } t#d dt| | zSt%dS|jdkrt%dS|jdkrt#dd|j|jzSd|jcxkrdkrnnt%dSd|jcxkrdkr!nn|jdz} t#dd| | zSd|jcxkrdkrnnt%dSd|jkr|jdz}t#dd||zSn| dkrj| dkrt%dS|st#dd| | zS| st#dd| | zS| dkrt%d St#d!d"| | zS| dkrh| s| st%d#S| st#d$d%| | zS|r)| dkrt%d&St#d'd(| | zSt#d$d%| | zSt#d)d*| d+d,t)| zS)-aReturn a natural representation of a timedelta or number of seconds. This is similar to `naturaltime`, but does not add tense to the result. Args: value (datetime.timedelta, int or float): A timedelta or a number of seconds. months (bool): If `True`, then a number of months (based on 30.5 days) will be used for fuzziness between years. minimum_unit (str): The lowest unit that can be used. Returns: str (str or `value`): A natural representation of the amount of time elapsed unless `value` is not datetime.timedelta or cannot be converted to int (cannot be float due to 'inf' or 'nan'). In that case, a `value` is returned unchanged. Raises: OverflowError: If `value` is too large to convert to datetime.timedelta. Examples: Compare two timestamps in a custom local timezone:: ```pycon >>> import datetime as dt >>> from dateutil.tz import gettz >>> berlin = gettz("Europe/Berlin") >>> now = dt.datetime.now(tz=berlin) >>> later = now + dt.timedelta(minutes=30) >>> assert naturaldelta(later - now) == "30 minutes" True ``` rNzMinimum unit 'z' not supportedr?m>@r%d microsecond%d microsecondsi@B%d millisecond%d millisecondsa momentza second< %d second %d secondsxza minute %d minute %d minutesi zan hour%d hour%d hoursza day%d day%d daysza month%d month %d monthsza yearz1 year, %d dayz1 year, %d daysz1 year, 1 monthz1 year, %d monthz1 year, %d months%d year%d years%d%s)r1rupperr(r'r&rDrArBrCfloatrErKabsr8r@ microsecondsr_replacer )rrIrJr3tmpmsgmin_unitr5 use_monthsyearsr8 num_months millisecondsminuteshourss r rr_srP |!!## $C 4<!2D4EFFF<|<<<ooH%&&  JJJ%LLE BL///EEI&   u::    J JJE J# E : DTT\""J EKTAXX =A  4,,,1Cd1J1J.0A5CUVV() 4,,,D---$%:L2X2X2X2Xy2X2X2X2X2X$1D8 .0A3|CTCTUU"#Z== =A  Z== =2  [, FFV V  $ $ $ $ $ $ $ $ $Z== %- & & & &$ & & & & &mr)G[,@@7J J 5= + + + +8 + + + + +Y<<  %-  MT)EY E::UB B  ! 199W::  ?Xy$77$> > ?Xy$77$> > ??Y<< [*== JJ ! $ X;;  O-/@$GG$N N  Q*+++,.A:NN  )+>& ! !!!(A%A%$A%cvddl} |j|j|j|j}n@#t $rt |cYSttf$rt |cYSwxYwt||j z }|j dkrt|dSt|S)zKLike `naturalday`, but append a year for dates more than ~five months away.rNgc@z%b %d %Y) r1rFrrrrrKrrDr9rr8r )rr3r5s r r r Fs EK;; 5zz : &5zz 527==??2 3 3E z\!!%,,, e  rrgdivisorunitsuppressIterable[Unit]tuple[float, float]c||krt|||z dfS||vrd|fSt||\}}|t|fS)a Divide `value` by `divisor`, returning the quotient and remainder. If `unit` is `minimum_unit`, the quotient will be the rounding of `value / divisor` according to the `format` string and the remainder will be zero. The rationale is that if `unit` is the unit of the quotient, we cannot represent the remainder because it would require a unit smaller than the `minimum_unit`. >>> from humanize.time import _quotient_and_remainder, Unit >>> _quotient_and_remainder(36, 24, Unit.DAYS, Unit.DAYS, [], "%0.2f") (1.5, 0) If `unit` is in `suppress`, the quotient will be zero and the remainder will be the initial value. The idea is that if we cannot use `unit`, we are forced to use a lower unit, so we cannot do the division. >>> _quotient_and_remainder(36, 24, Unit.DAYS, Unit.HOURS, [Unit.DAYS], "%0.2f") (0, 36) In other cases, return the quotient and remainder as `divmod` would do it. >>> _quotient_and_remainder(36, 24, Unit.DAYS, Unit.HOURS, [], "%0.2f") (1, 12) r)_rounding_by_fmtdivmodrC)rrrrJrrqrs r _quotient_and_remainderrXsb@ |88!;; x%x % ! !DAq c!ff9r"rnc`||vr)tD]}||kr||vr|cSd}t||S)aReturn a minimum unit suitable that is not suppressed. If not suppressed, return the same unit: >>> from humanize.time import _suitable_minimum_unit, Unit >>> _suitable_minimum_unit(Unit.HOURS, []).name 'HOURS' But if suppressed, find a unit greater than the original one that is not suppressed: >>> _suitable_minimum_unit(Unit.HOURS, [Unit.HOURS]).name 'DAYS' >>> _suitable_minimum_unit(Unit.HOURS, [Unit.HOURS, Unit.DAYS]).name 'MONTHS' z@Minimum unit is suppressed and no suitable replacement was found)rrD)rnrrrms r _suitable_minimum_unitrsQ$8  Dh4x#7#7 Poo Or" set[Unit]crt|}tD]}||krn|| |S)aExtend suppressed units (if any) with all units lower than the minimum unit. >>> from humanize.time import _suppress_lower_units, Unit >>> [x.name for x in sorted(_suppress_lower_units(Unit.SECONDS, [Unit.DAYS]))] ['MICROSECONDS', 'MILLISECONDS', 'DAYS'] )setradd)rnrrs r _suppress_lower_unitsrsH8}}H 8   E T Or"r.%0.2fdt.timedelta | float | None Iterable[str]c t|d\}}|t|Sd|D}t|}t ||}~t ||}|j}|j} |j} tt\} } } }}}}}t|d||||\}}t|d||||\}}|dzdz| z} t| d ||||\}} t| d||||\}} t| d ||||\}} | d z| z} t| d | |||\} } t| d | |||\}} |d kr| |vr |d z}| d z } | d kr||vr | d z} |d z }|d kr||vr |d z}|d z }|dkr||vr |dz}|d z }|dkr||vr |dz}|d z }|dkr||vr |dz}|d z }dd|fdd|fdd|fdd|fdd|fdd| fdd|fdd| fg}g}ttt|D]\}}|\}}}|d ks |s||krd |cxkrd!krnnd!nt|}t|||} d dl}!||kr6|!|d d kr| d"|} np||krj|!|d d krt|}| d"d#} || t'|z|| |z||krnt)|d kr|d Sd$|dd%}"|d%}#t-d&|"|#fzS)'a:Return a precise representation of a timedelta or number of seconds. ```pycon >>> import datetime as dt >>> from humanize.time import precisedelta >>> delta = dt.timedelta(seconds=3633, days=2, microseconds=123000) >>> precisedelta(delta) '2 days, 1 hour and 33.12 seconds' ``` A custom `format` can be specified to control how the fractional part is represented: ```pycon >>> precisedelta(delta, format="%0.4f") '2 days, 1 hour and 33.1230 seconds' ``` Instead, the `minimum_unit` can be changed to have a better resolution; the function will still readjust the unit to use the greatest of the units that does not lose precision. For example setting microseconds but still representing the date with milliseconds: ```pycon >>> precisedelta(delta, minimum_unit="microseconds") '2 days, 1 hour, 33 seconds and 123 milliseconds' ``` If desired, some units can be suppressed: you will not see them represented and the time of the other units will be adjusted to keep representing the same timedelta: ```pycon >>> precisedelta(delta, suppress=['days']) '49 hours and 33.12 seconds' ``` Note that microseconds precision is lost if the seconds and all the units below are suppressed: ```pycon >>> delta = dt.timedelta(seconds=90, microseconds=100) >>> precisedelta(delta, suppress=['seconds', 'milliseconds', 'microseconds']) '1.50 minutes' ``` If the delta is too small to be represented with the minimum unit, a value of zero will be returned: ```pycon >>> delta = dt.timedelta(seconds=1) >>> precisedelta(delta, minimum_unit="minutes") '0.02 minutes' >>> delta = dt.timedelta(seconds=0.1) >>> precisedelta(delta, minimum_unit="minutes") '0 minutes' ``` T)r:NcLh|]!}t|"Sr.)rrf).0ss r zprecisedelta..s$666DO666r"rMrNrYiQrUg.ArOr rbrcr`rar^r_r\r]rZr[rVrWrRrSrPrQrrrdrez, rz %s and %s)rGrKrrfrrr8r@rilistrzipreversedrCrmathmodfrkappendr lenjoinrj)$rrJrrrFr5 suppress_setrnr8secsusecsr&r'r(r)r*r+r,r-rprIrtrsmsecsfmtstextsrfmt singular_txt plural_txt fmt_value _fmt_valuefmt_txtrheadtails$ r rrsP"%666KD% |5zz66X666LL&&(()H%h ==H)<@@L :D =D  EOS PPLL,%vu * c5(L&KE4+ dFHlFLFD "9t d "D( ixvJD$* dE8\6KE4, b'8\6MGT 3J E) sGX|VKD%+ t\8\6LE5 ~~'55    rzzg\11  1 "}}l222    {{t<//     rzzfL00  !  ||\11"    J& [&) 9d# J& lG, lD) ,e4 ,e4 DE$.. c.1+ j) q===48+;+;)////a/////S^^J j*EEG KKKxDIIi$8$8$;a$?$?!//$7799Y''*a// #II!//$55 Wx ':'::;;; LL9, - - - 8   E  5zzQQx 99U3B3Z D 9D [>>T4L ((r" float | intcp||z} t|}n#t$rt|}YnwxYw|S)alRound a number according to the string format provided. The string format is the old printf-style string formatting. If we are using a format which truncates the value, such as "%d" or "%i", the returned value will be of type `int`. If we are using a format which rounds the value, such as "%.2f" or even "%.0f", we will return a float. )rCrDrg)rrresults r rr}sPe^FF  f  Ls 33)rr/)r5r6rr6)rr r2r;r:r<rr=)Tr@)rrHrIr<rJrKrrK)FTr@N) rrurvr<rIr<rJrKrwr;rrK)rr{rr )r)rrrrKrrK)rrrrK)rrgrrgrrrJrrrrrKrr)rnrrrrr)rnrrrrr)r@r.r) rrrJrKrrrrKrrK)rrKrrgrr)#__doc__ __future__renumr functoolsri18nrrjrnumberr TYPE_CHECKINGr1r3collections.abcr typingr __all__rr4r9rGrrryr r rrrrrr.r"r rsi #"""""$$$$$$ ((((((        4         .25'''''':!HYHYHYHYHYZ!# .....b"""""@$****Z:    $"  H)H)H)H)H)Vr"