.iPdZddlmZddlmZddlmZddlmZ ddlm Z ddl m Z d Z e rdd lZdd lmZdd lmZgd ZeGddeZddZddZd d d d dZ d! d"dZ d# d$dZ d%dZd&d'dZd(dZ d)dZd*dZd+dZ d, d-dZ!d.dZ"y )/zYTime humanizing functions. These are largely borrowed from Django's `contrib.humanize`. ) annotations)Enum)total_ordering)_gettext) _ngettext)intcommaFN)Iterable)Any) naturaldate naturalday naturaldelta naturaltime precisedeltac4eZdZdZdZdZdZdZdZdZ dZ d d Z y ) Unitrrcp|j|jur|j|jkStS)N) __class__valueNotImplemented)selfothers I/mnt/e/genesis-system/.venv/lib/python3.12/site-packages/humanize/time.py__lt__z Unit.__lt__)s+ >>U__ ,:: + +N)rr returnr ) __name__ __module__ __qualname__ MICROSECONDS MILLISECONDSSECONDSMINUTESHOURSDAYSMONTHSYEARSr r!rrrs/LLGG E D F Er!rc>ddl}|jjS)Nr)datetimenow)dts r_nowr3/s ;;?? r!cH|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)daysr3)deltar1s r_abs_timedeltar75s* zzA~fcEk"" Lr!)r1precisec6ddl}|s t}t||jr|}||z }nFt||jr||z }|}n( |r|n t |}|j|}||z }|t|fS#t t f$rd|fcYSwxYw)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)r0r3 isinstance timedeltaround ValueError TypeErrorr7)rr1r8r2dater6s r_date_and_deltarBDs f%%e  E2<< (U{ $E%,E BLL/E;D & &&I& ;  s'BBBcddl}t|j}|tjtjtj fvrd|d}t ||}t||jr|}n* t|t|}|j|}|}t|}|jdz} |jdz} t| dz } | dk(r| dkr|j dk(r|tj k(r3|j"d kr$t%d d |j"|j"zS|tjk(s5|tj k(rJd |j"cxkrd kr5n t'dS|j"d z } t%d dt| | zSt'dS|j dk(r t'dS|j dkr$t%dd|j |j zSd|j cxkrdkrKnnHt|j dz } | dk(r t'dS| dk(r t'dSt%dd| | zSd|j kr/t|j dz }|dk(r t'dS|dk(r t'dSt%dd||zS| dk(rg| dk(r t'dS|st%dd| | zS| dk(rt%dd| | zS| dk(r t'dS| d k(r t'd!St%d"d#| | zS| dk(rv| dk(r| dk(r t'd!S| dk(rt%d$d%| | zS|r:| dk(r t'd&S| d k(r| dz } t%d'd(| | zSt%d)d*| | zSt%d$d%| | zSt%d'd(| j)d+d,t+| zS#t tf$rt|cYSwxYw)-aReturn a natural representation of a timedelta or number of seconds. This is similar to `naturaltime`, but does not add tense to the result. The timedelta will be rounded to the nearest unit that makes sense. 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 secondsza minutezan hour %d minute %d minutesza day%d hour%d hours%d day%d daysza month za year%d month %d monthsz1 year, %d dayz1 year, %d daysz1 year, 1 month%d year%d yearsz1 year, %d monthz1 year, %d months%d%s)r0rupperr(r'r&r?r<r=intfloatr@strabsr5r>r; microsecondsr_replacer )rmonths minimum_unitr2tmpmsgmin_unitr6 use_monthsyearsr5 num_months millisecondsminuteshourss rrr_sT |!!# $C 4<<!2!2D4E4EFF|nO<oH%&  J%LE BLL/EJ JE JJ# E :: Dtd{#J zdQh ==A 4,,,1C1Cd1J.0A5CUCUV(() 4,,,D---$%:L:L2Xy2XZ= %11D8 .0A3|CTU"#Z= ==A Z= ==2 [, FV V  % %EMMB./G!|}$"}|#[,@7J J 5== %--$./Ez|#{z!Y E:UB B ! 19W: Xy$7$> > ?Xy$7$> > ?Y<   X; [*= JJ ! ?tqyX;  ?-/@$G$N N Q*++R  J>FF,.A:N  )+%%%,,*B ))%//*;< Lr!cddl} |j|j|j|j}||jjz }|jdk(r tdS|jdk(r tdS|jdk(r tdS|j|S#t $rt |cYSttf$rt |cYSwxYw)zReturn a natural day. For date values that are tomorrow, today or yesterday compared to present day return representing string. Otherwise, return a string formatted according to `format`. rNtodayrtomorrow yesterday) r0rAyearmonthdayAttributeErrorra OverflowErrorr?r{r5rdstrftime)rformatr2r6s rr r 7s EKK; BGGMMO #E zzQz zzQ} zzR~ >>& !!# 5z : &5zs2B44C& C&%C&crddl} |j|j|j|j}t||jjz }|jdk\r t|dSt|S#t $rt |cYSttf$rt |cYSwxYw)zKLike `naturalday`, but append a year for dates more than ~five months away.rNgc@z%b %d %Y) r0rArrrrrarr?r7r{r5r )rr2r6s rr r Ws EKK; 5277==?2 3E zz\!%,, e  5z : &5zs2BB6B65B6cv||k(rt|||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_fmtdivmodr_)rdivisorunitrgsuppressrqrs r_quotient_and_remainderrisT@ |8!;; x%x % !DAq c!f9r!cZ||vr&tD]}||kDs ||vs|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)rr?)rjrrris r_suitable_minimum_unitrsE$8 Dh4x#7  Qo Or!cdt|}tD]}||k(r|S|j||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)rjrrs r_suppress_lower_unitsrsC8}H 8   O  T Or!c :t|d\}}| t|S|Dchc]}t|j}}t|j}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 k\r||vr |d z}| d z } | d k\r||vr | d z} |d z }|d k\r||vr |d z}|d z }|dk\r||vr |dz}| d z } | d k\r||vr | d z} |d z }|dk\r||vr |dz}|d z }dd|fdd|fdd| fdd|fdd|fdd| fdd|fdd| fg}g}ttt|D]\}}|\}}}|dkDs|s||k(rd |cxkrd krnnd n t|} t||| }!ddl}"||k(r*|"j!|ddkDr|!j#d!|}!nW||k(rR|"j!|ddk(r t|}|!j#d!d"}!|j%|!t'|z|j%|!|z||k(snt)|d k(r|dSd#j+|dd$}#|d$}$t-d%|#|$fzScc}w)&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)r8NrDrErRrOiQrLg.ArFrrWrZr[rXrYrUrVrSrTrPrQrMrNrIrJrGrHrrr\r]z, r}z %s and %s)rBrarr^rrr5r;rclistrzipreversedr_rmathmodfreappendr lenjoinrd)%rrgrrrAr6s suppress_setrjr5secsusecsr&r'r(r)r*r+r,r-rlrfrpromsecsfmtstextsrfmt singular_txt plural_txt fmt_value _fmt_valuefmt_txtrheadtails% rrrs P"%6KD% |5z-56DO6L6L&&()H%h =H)<@L ::D ==D   EOS PLL,%vu * c5(L&KE4+ dFHlFLFD "9t d "D( ixvJD$* dE8\6KE4, b'8\6MGT 3J E) sGX|VKD%+ t\8\6LE5 ~'5    rzg\1  1 "}l22    {t</     rzfL0  !  |\1"    J& [&) 9d# J& lG, lD) ,e4 ,e4 DE$. c.1+ j) q=48+;)/a/S^J j*EG xDIIi$8$;a$?!//$799Y'*a/ #II!//$5 Wx '::; LL9, - 8  '* 5zQQx 99U3BZ D 9D [>T4L ((y7sLc^||z} t|}|S#t$rt|}Y|SwxYw)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. )r_r?r`)rrresults rrrsAe^FF  L f  Ls ,,)r"z dt.datetime)r6 dt.timedeltar"r)rr r1dt.datetime | Noner8boolr"ztuple[Any, Any])Tr;)rzdt.timedelta | floatrfrrgrar"ra)FTr;N) rz"dt.datetime | dt.timedelta | floatrsrrfrrgrartrr"ra)rz)dt.datetime | dt.timedelta | float | Noner"r )z%b %d)rdt.date | dt.datetimerrar"ra)rrr"ra)rr`rr`rrrgrrIterable[Unit]rrar"ztuple[float, float])rjrrrr"r)rjrrrr"z set[Unit])r;r.z%0.2f) rzdt.timedelta | float | Nonergrarz Iterable[str]rrar"ra)rrarr`r"z float | int)#__doc__ __future__renumr functoolsri18nrrdrnumberr TYPE_CHECKINGr0r2collections.abcr typingr __all__rr3r7rBrrrrr r rrrrrr.r!rrs #$ (  4     .25' '*'<@'':!WY WY WYWY WYx!# 0 -0 0 0 0  0  0f 4"@$* * * * *  *  **Z: $"  H) &H)H)H)  H)  H)Vr!