I|* w4UdZddlmZddlZddlZddlZddlmZddlm Z ddl m Z ddl m Z mZmZdd l mZdd l mZe rej(d k\rdd lmZndd lmZd Zded<d'dZd(d)dZd*d+dZdDcgc]}d|z c}Zeddeddeddeddeddeddeddeddeddeddedded d f Zd,d-d!Zd.d"Zd.d#Z d/d0d$Z! d1 d2d%Z"d3d4d&Z#ycc}w)5z!Humanizing functions for numbers.) annotationsN)Fraction) TYPE_CHECKING)_gettext) _ngettextdecimal_separatorthousands_separator)_ngettext_noop) _pgettext) ) TypeAliasz float | strrNumberOrStringctj|rytj|r|dkrytj|r|dkDryy)z2Utility function to handle infinite and nan cases.NaNrz-Infz+Inf)mathisnanisinfvalues 4/usr/lib/python3.12/site-packages/humanize/number.py_format_not_finiters> zz% zz%UQY zz%UQY c  tjt|stt|St |}|dk(rqtddtddtddtdd td dtd dtd dtd dtddtddf }nptddtddtddtdd tddtddtddtddtddtddf }|dzdvr ||dS|||dzS#t t f$rt|cYSwxYw)akConverts an integer to its ordinal as a string. For example, 1 is "1st", 2 is "2nd", 3 is "3rd", etc. Works for any integer or anything `int()` will turn into an integer. Anything else will return the output of str(value). Examples: ```pycon >>> ordinal(1) '1st' >>> ordinal(1002) '1002nd' >>> ordinal(103) '103rd' >>> ordinal(4) '4th' >>> ordinal(12) '12th' >>> ordinal(101) '101st' >>> ordinal(111) '111th' >>> ordinal("something else") 'something else' >>> ordinal([1, 2, 3]) == "[1, 2, 3]" True ``` Args: value (int, str, float): Integer to convert. gender (str): Gender for translations. Accepts either "male" or "female". Returns: str: Ordinal string. malez0 (male)thz1 (male)stz2 (male)ndz3 (male)rdz4 (male)z5 (male)z6 (male)z7 (male)z8 (male)z9 (male)z 0 (female)z 1 (female)z 2 (female)z 3 (female)z 4 (female)z 5 (female)z 6 (female)z 7 (female)z 8 (female)z 9 (female)d) rr) risfinitefloatrint TypeError ValueErrorstrP_)rgenderts rordinalr/%sjJ}}U5\*%eEl3 3E  z4 z4 z4 z4 z4 z4 z4 z4 z4 z4   |T " |T " |T " |T " |T " |T " |T " |T " |T " |T "  s{l"1WQurz]O $$= z "5zs1E EEEct}t} t|trp|j |dj |d}t j t|stt|Sd|vr t|}nIt|}n=t j t|stt|St||dj||}n t|}|j d|} tjdd|d|}||k(r|S|}%#ttf$rt|cYSwxYw)aConverts an integer to a string containing commas every three digits. For example, 3000 becomes "3,000" and 45000 becomes "45,000". To maintain some compatibility with Django's `intcomma`, this function also accepts floats. Examples: ```pycon >>> intcomma(100) '100' >>> intcomma("1000") '1,000' >>> intcomma(1_000_000) '1,000,000' >>> intcomma(1_234_567.25) '1,234,567.25' >>> intcomma(1234.5454545, 2) '1,234.55' >>> intcomma(14308.40, 1) '14,308.4' >>> intcomma("14308.40", 1) '14,308.4' >>> intcomma(None) 'None' ``` Args: value (int, float, str): Integer or float to convert. ndigits (int, None): Digits of precision for rounding after the decimal point. Returns: str: String containing commas every three digits. r.z {0:.{1}f}z^(-?\d+)(\d{3})z\g<1>z\g<2>)r r isinstancer+replacerr&r'rr(r)r*formatresub)rndigits thousands_sep decimal_seporignews rintcommar<os'D()M#%K eS !MM-4<<[#NE==u.)%,77e|e E ==u.)%,77 %L!!%15z <<[ )D ff'E-)FM 3;J  z "5zsA#D+:A D+ D++EE) r  r$!r"rthousandmillionbilliontrillion quadrillion quintillion sextillion septillion octillion nonillion decilliongoogolc . tjt|stt|St |}|dkr|dz}d}nd}|tdkr|t|zSttdddD]\}}||ks |tt|dz z }t|t|dz z }t||z|k(rZ|tt|z }t|\}}|dj|t||tj|gz|zcSt|dz \}}|dj|t||tj|gz|zcS|t|zS#t t f$rt|cYSwxYw)aConverts a large integer to a friendly text representation. Works best for numbers over 1 million. For example, 1_000_000 becomes "1.0 million", 1200000 becomes "1.2 million" and "1_200_000_000" becomes "1.2 billion". Supports up to decillion (33 digits) and googol (100 digits). Examples: ```pycon >>> intword("100") '100' >>> intword("12400") '12.4 thousand' >>> intword("1000000") '1.0 million' >>> intword(1_200_000_000) '1.2 billion' >>> intword(8100000000000000000000000000000000) '8.1 decillion' >>> intword(None) 'None' >>> intword("1234000", "%0.3f") '1.234 million' ``` Args: value (int, float, str): Integer to convert. format (str): To change the number of decimal or general format of the number portion. Returns: str: Friendly text representation as a string, unless the value passed could not be coaxed into an `int`. r-rrN )rr&r'rr(r)r*r+powers enumerate human_powersjoinrceil) rr4negative_prefixordinal_powerchoppedpowers_differencesingularplurals rintwordrbsF}}U5\*%eEl3 3E  qy   vayU++$VABZ3% 5=eF8a<$899G &x 06(Q,3G G Vg%&*;;%x(8"99#/#9 &#hh8VTYYw=O!PQ  ,HqL9 Hf((FIh '@R$STUV 4( SZ ''A z "5zs1E7 E77FFc  tjt|stt|St |}d|cxkrdkst|St|Stdtdtdtdtdtdtd td td td f |S#t t f$rt|cYSwxYw) aJConverts an integer to Associated Press style. Examples: ```pycon >>> apnumber(0) 'zero' >>> apnumber(5) 'five' >>> apnumber(10) '10' >>> apnumber("7") 'seven' >>> apnumber("foo") 'foo' >>> apnumber(None) 'None' ``` Args: value (int, float, str): Integer to convert. Returns: str: For numbers 0-9, the number spelled out. Otherwise, the number. This always returns a string unless the value was not `int`-able, then `str(value)` is returned. rrzeroonetwothreefourfivesixseveneightnine) rr&r'rr(r)r*r+_rs rapnumberro s8}}U5\*%eEl3 3E  ??5z 5z &  % % '  &  &  % '  '  &     z "5zs1C C C'&C'cf t|}tj|s t|S t|}t||z jd}|j}|j}|r |s |dk(r|dS|s |dd|dS|dd|dd|dS#tt f$rt |cYSwxYw)aConvert to fractional number. There will be some cases where one might not want to show ugly decimal places for floats and decimals. This function returns a human-readable fractional number in form of fractions and mixed fractions. Pass in a string, or a number or a float, and this function returns: * a string representation of a fraction * or a whole number * or a mixed fraction * or the str output of the value, if it could not be converted Examples: ```pycon >>> fractional(0.3) '3/10' >>> fractional(1.3) '1 3/10' >>> fractional(float(1/3)) '1/3' >>> fractional(1) '1' >>> fractional("ten") 'ten' >>> fractional(None) 'None' ``` Args: value (int, float, str): Integer to convert. Returns: str: Fractional number as a string. irz.0f/rU) r'rr&rr)r*r+r(rlimit_denominator numerator denominator)rnumber whole_numberfracrsrts r fractionalrx<sNu}}V$%f- -%v;L F\) * < >> scientific(float(0.3)) '3.00 x 10⁻¹' >>> scientific(int(500)) '5.00 x 10²' >>> scientific(-1000) '-1.00 x 10³' >>> scientific(1000, 1) '1.0 x 10³' >>> scientific(1000, 3) '1.000 x 10³' >>> scientific("99") '9.90 x 10¹' >>> scientific("foo") 'foo' >>> scientific(None) 'None' ``` Args: value (int, float, str): Input number. precision (int): Number of decimal for first part of the number. Returns: str: Number in scientific notation z.wq x 10ⁿ. u⁰¹²³u⁴u⁵u⁶u⁷u⁸u⁹u⁻) 0123456789rTz{:.%se}ez^\+?(\-?)0*(.+)$z\1\2z x 10r)r'rr&rr*r)r+r(r4splitr5r6appendrY) r precision exponentsfmtnpart1part2 new_part2char final_strs r scientificrxs@           Ie }}U#%e, ,$ c#i.) )C 5A773>> clamp(123.456) '123.456' >>> clamp(0.0001, floor=0.01) '<0.01' >>> clamp(0.99, format="{:.0%}", ceil=0.99) '99%' >>> clamp(0.999, format="{:.0%}", ceil=0.99) '>99%' >>> clamp(1, format=intword, floor=1e6, floor_token="under ") 'under 1.0 million' >>> clamp(None) is None True ``` Args: value (int, float): Input number. format (str OR callable): Can either be a formatting string, or a callable function that receives value and returns a string. floor (int, float): Smallest value before clamping. ceil (int, float): Largest value before clamping. floor_token (str): If value is smaller than floor, token will be prepended to output. ceil_token (str): If value is larger than ceil, token will be prepended to output. Returns: str: Formatted number. The output is clamped between the indicated floor and ceil. If the number is larger than ceil or smaller than floor, the output will be prepended with a token indicating as such. NrzpInvalid format. Must be either a valid formatting string, or a function that accepts value and returns a string.)rr&rr2r+r4callabler*)rr4floorrZ floor_token ceil_tokentokenmsgs rclamprs^ } == !%(( UU] edl&#v}}U+++ve}$$ 3 S/rc tj|s t|S|dk7r:ttjtj t |nd}|dk\s|dkrt||dz |zS|d|dzdzzz}|dk\r d|dzdz }n|dkr d| dz dz}nd }t|d ||dzz dz z}|s|r|d vrd }nd }||||S) uReturn a value with a metric SI unit-prefix appended. Examples: ```pycon >>> metric(1500, "V") '1.50 kV' >>> metric(2e8, "W") '200 MW' >>> metric(220e-6, "F") '220 μF' >>> metric(1e-14, precision=4) '10.00 f' ``` The unit prefix is always chosen so that non-significant zero digits are required. i.e. `123,000` will become `123k` instead of `0.123M` and `1,230,000` will become `1.23M` instead of `1230K`. For numbers that are either too huge or too tiny to represent without resorting to either leading or trailing zeroes, it falls back to `scientific()`. ```pycon >>> metric(1e40) '1.00 x 10⁴⁰' ``` Args: value (int, float): Input number. unit (str): Optional base unit. precision (int): The number of digits the output should contain. Returns: str: rrEirrr kMGTPEZYRQu mμnpfazyrqrz.%if)°u′u″rU) rr&rr(rlog10absrr4)runitrexponentr\value_spaces rmetricrsF == !%((:?1*s4::djjU456!H2~C%Q/$66 RHMA% &&E1}A  12 A 8)a-A!56 E6Y(Q,%?!%CD EF H)=!=XeWXJtf --r)rr'returnr+)r)rrr-r+rr+)N)rrr7z int | Nonerr+)z%.1f)rrr4r+rr+)rrrr+))rrrr(rr+)z{:}NN<>)rr'r4r+r float | NonerZrrr+rr+rr+)rr )rr'rr+rr(rr+)$__doc__ __future__rrr5sys fractionsrtypingri18nrrnrr r r NS_r r, version_infortyping_extensionsr__annotations__rr/r<rVrXrbrorxrrr)xs0rrs'"  CC'! 7"$/* )G%T=@H HGA"a%G H J 9 9 J }% }% l# l# [! [! [!(  G(T/ d9Cx>F H H H H  H  H  H HV7.k Is5 D