_EzydZddlmZddlZddlZddlZddlZddl m Z ddl m Z ddlm Z ddlmZdd lmZdd lmZgd Ze Gd d e ZddZddZdd ddZ d d dZ d! d"dZ d#dZd$d%dZd&dZ d'dZ d(dZd)dZ d*dZ! d+ d,dZ"y)-zYTime humanizing functions. These are largely borrowed from Django's `contrib.humanize`. ) annotationsN)Enum)total_ordering)Any)_gettext) _ngettext)intcomma) naturaldelta naturaltime naturalday naturaldate precisedeltac4eZdZdZdZdZdZdZdZdZ dZ d d Z y ) Unitrrcp|j|jur|j|jkStSN) __class__valueNotImplemented)selfothers 2/usr/lib/python3.12/site-packages/humanize/time.py__lt__z Unit.__lt__'s+ >>U__ ,:: + +N)r typing.Anyreturnr") __name__ __module__ __qualname__ MICROSECONDS MILLISECONDSSECONDSMINUTESHOURSDAYSMONTHSYEARSr r!rrrs/LLGG E D F Er!rc>tjjSr)dtdatetimenowr/r!r_nowr4-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)daysr4)deltar3s r_abs_timedeltar81s* zzA~fcEk"" Lr!r3c<|s t}t|tjr|}||z }nIt|tjr||z }|}n' t |}tj|}||z }|t|fS#t tf$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)`. secondsN) r4 isinstancer1r2 timedeltaint ValueError TypeErrorr8)rr3dater7s r_date_and_deltarC@s f%%e  E2<< (U{ JELL/E;D & &&I& ;  s&BBBcpt|j}|tjtjtjfvrd|d}t ||}t |tjr|}n" t|}tj|}|}t|j}t|j} | dz} | dz} t| dz} | s\| dkrV|dk(r|tjk(r3|jdkr$t!d d |j|jzS|tjk(s5|tjk(rJd|jcxkrd kr5n t#dS|jdz } t!d d t| | zSt#dS|dk(r t#dS|dkrt!dd||zSd|cxkrdkr t#dSd|cxkrdkrnn|dz} t!dd| | zSd|cxkrdkr t#dSd|kr|dz}t!dd||zS| dk(rT| dk(r t#dS|st!dd| | zS| st!dd| | zS| dk(r t#dSt!d d!| | zS| dk(rS| s | s t#d"S| st!d#d$| | zS|r | dk(r t#d%St!d&d'| | zSt!d#d$| | zSt!d(d)| j%d*d+t'| zS#t tf$rt|cYSwxYw),aTReturn 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. 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:: 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" zMinimum unit 'z' not supportedr;m>@rr%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)rupperr)r(r'r@r=r1r>r?rAstrabsr<r6 microsecondsr _replacer )rmonths minimum_unittmpmsgmin_unitr7 use_monthsr<r6years num_months millisecondsminuteshourss rr r YssF |!!# $C 4<<!2!2D4E4EFF|nO<oH%& JELL/EJ%-- G uzz?D CKE #:DTT\"J TAX a<4,,,1C1Cd1J.0A5CUCUV(() 4,,,D---$%:L:L2Xy2XZ= %11D8 .0A3|CTU"#Z= a<Z= R<[,@7J J  3 Z=   ' D mG[,@7J J 7 %X %Y<  & '>tOEY E:UB B ! 19W: Xy$7$> >Xy$7$> > ?Y< [*= JJ !$X; -/@$G$N N Q*++,.A:N  )+rbr ) rfuturerdrewhenr3rBr7agos rr r s4 $E *E "4 (D .$&C!%S1KD% |5z%"++r||45$!M !H+C  5E * x sU{ r!ct|tjr9|j-tjj |j }|S)zIConvert aware datetime to naive datetime and pass through any other type.)r=r1r2tzinfo fromtimestamp timestamp)rs rrprp s;%%%,,*B ))%//*;< Lr!c tj|j|j|j}|tjjz }|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`. rtodayrtomorrow yesterday) r1rByearmonthdayAttributeErrorr_ OverflowErrorr@ryr6rbstrftime)rformatr7s rr r s EKK; BGGMMO #E zzQz zzQ} zzR~ >>& !!# 5z : &5zs5B77C) C)(C)cx tj|j|j|j}t|tjjz }|jdk\r t|dSt|S#t $rt |cYSttf$rt |cYSwxYw)zKLike `naturalday`, but append a year for dates more than ~five months away.gc@z%b %d %Y) r1rBr}r~rrr_rr@r8ryr6r )rr7s rrr3s EKK; 5277==?2 3E zz\!%,, e  5z : &5zs5BB9B98B9cB||k(r||z dfS||vrd|fSt||S)aDivide `value` by `divisor` returning the quotient and remainder. If `unit` is `minimum_unit`, makes the quotient a float number and the remainder will be zero. The rational 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, []) (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, 36) In other case return quotient and remainder as `divmod` would do it. >>> _quotient_and_remainder(36, 24, Unit.DAYS, Unit.HOURS, []) (1, 12) r)divmod)rdivisorunitresuppresss r_quotient_and_remainderrCs9> |w!! x%x % !!r!cD||k(r |||z zdfS||vr d|||zzfS||fS)aReturn a tuple with two values. If the unit is in `suppress`, multiply `value1` by `ratio` and add it to `value2` (carry to right). The idea is that if we cannot represent `value1` we need to represent it in a lower unit. >>> from humanize.time import _carry, Unit >>> _carry(2, 6, 24, Unit.DAYS, Unit.SECONDS, [Unit.DAYS]) (0, 54) If the unit is the minimum unit, `value2` is divided by `ratio` and added to `value1` (carry to left). We assume that `value2` has a lower unit so we need to carry it to `value1`. >>> _carry(2, 6, 24, Unit.DAYS, Unit.DAYS, []) (2.25, 0) Otherwise, just return the same input: >>> _carry(2, 6, 24, Unit.DAYS, Unit.SECONDS, []) (2, 6) rr/)value1value2ratiorrhrs r_carryrksF< x&)) x&6E>))) 6>r!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@)rhrrrgs r_suitable_minimum_unitrs@$8Dh4x#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)rhrrs r_suppress_lower_unitsrs>8}H 8   O  T Or!c t|\}}| t|S|Dchc]}t|j}}t|j}t ||}~t ||}|j } |j} |j} tt\} } }}}}}}t| d|||\}} t| d|||\}} t| | d|||\} } t| d|||\}} t| d|||\}} t| | d|||\} } t| d| ||\}} t| d d | ||\} }d d |fd d|fdd| fdd|fdd|fdd| fdd|fdd| fg}g}ttt|D]\}}|\}}} | d kDs|s||k(rd | cxkrdkrnndn t| }!t|||!}"||k(r.t!j"| d d kDr|"j%d|}"n5||k(r0|"j%dd}"|j'|"t)| z|j'|"| z||k(snt+|d k(r|d Sdj-|dd}#|d}$t/d |#|$fzScc}w)!a%Return a precise representation of a timedelta. ```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' ``` NrErFiQrQrMg.ArGrrrZr[rXrYrVrWrTrUrRrSrNrOrJrKrHrIrr\r]z, r{z %s and %s)rCr_rr^rrr6r<ralistrrzipreversedr?r mathmodfrcappendr lenjoinrb)%rrerrrBr7s suppress_setrhr6secsusecsr'r(r)r*r+r,r-r.rjrdrnrmmsecs_unusedfmtstextsrfmt singular_txt plural_txt fmt_value _fmt_valuefmt_txtheadtails% rrrsP"%(KD% |5z-56XDOXL6L&&()H%h =H)<@L ::D ==D   EOS PLL,%vu *$UHlSKE4*4vxVLFDdItX|LJD$)$eX|TKE4+D"gxVMGTuc7HlKKD%* t\8\LE5 E1axNNE7 J& [&) 9d# J& lG, lD) ,e4 ,e4 DE$. c.1+ j) q=48+;)/a/S^J j*EGxDIIi$8$;a$?!//$7!//$5 Wx '::; LL9, - 8  /" 5zQQx 99U3BZ D 9D [>T4L ((u7sI=)r#z dt.datetime)r7 dt.timedeltar#r)rr"r3dt.datetime | Noner#ztuple[typing.Any, typing.Any])Tr<)rzdt.timedelta | floatrdboolrer_r#r_)FTr<N) rz"dt.datetime | dt.timedelta | floatrqrrdrrer_rrrr#r_)rz)dt.datetime | dt.timedelta | float | Noner#r)z%b %d)rdt.date | dt.datetimerr_r#r_)rrr#r_) rfloatrrrrrerrzcollections.abc.Iterable[Unit]r#tuple[float, float])rrrrrrrrrhrrtyping.Iterable[Unit]r#r)rhrrrr#r)rhrrrr#z set[Unit])r<r/z%0.2f) rzdt.timedelta | int | Nonerer_rztyping.Iterable[str]rr_r#r_)#__doc__ __future__rcollections.abc collectionsr2r1rtypingenumr functoolsrri18nrrbr numberr __all__rr4r8rCr r rpr rrrrrrr/r!rrs# $  4     59' '1'"'6!AY AY AYAY AYL!# , -, , , ,  ,  ,^ 4"<  %" %" %" %" %" - %"  %"P$ $ $ $  $  $ $ $$N: $"%' f) $f)f)#f)  f)  f)r!