Mh|kHdZddlmZddlZddlZddlZddlmZddlm Z m Z m Z m Z m Z ddlmZddlmZmZmZmZddlmZmZmZmZmZmZe rddlZdd lmZdd lm Z Gd d Z!Gd dZ"Gddej#Z#Gdde#ej$Z%ddZ&dS)a- babel.support ~~~~~~~~~~~~~ Several classes and functions that help with integrating and using Babel in applications. .. note: the code in this module is not used by Babel itself :copyright: (c) 2013-2025 by the Babel Team. :license: BSD, see LICENSE for more details. ) annotationsN)Iterator) TYPE_CHECKINGAnyCallableIterableLiteral)Locale) format_dateformat_datetime format_timeformat_timedelta)format_compact_currencyformat_compact_decimalformat_currencyformat_decimalformat_percentformat_scientific)Decimal)_PredefinedTimeFormatceZdZdZ d:ddd;d Z ddZ d>> from babel.util import UTC >>> from datetime import date >>> fmt = Format('en_US', UTC) >>> fmt.date(date(2007, 4, 1)) u'Apr 1, 2007' >>> fmt.decimal(1.2345) u'1.234' Nlatn)numbering_systemlocale Locale | strtzinfo_datetime.tzinfo | NonerLiteral['default'] | strreturnNonecTtj||_||_||_dS)aInitialize the formatter. :param locale: the locale identifier or `Locale` instance :param tzinfo: the time-zone info (a `tzinfo` instance or `None`) :param numbering_system: The numbering system used for formatting number symbols. Defaults to "latn". The special value "default" will use the default numbering system of the locale. N)r parserrr)selfrrrs M/var/www/html/test/jupyter/venv/lib/python3.11/site-packages/babel/support.py__init__zFormat.__init__4s*l6**  0mediumdate_datetime.date | Noneformat_PredefinedTimeFormat | strstrc0t|||jS)zReturn a date formatted according to the given pattern. >>> from datetime import date >>> fmt = Format('en_US') >>> fmt.date(date(2007, 4, 1)) u'Apr 1, 2007' )r)r r)r$r)r+s r%r)z Format.dateFs4 <<<>> from datetime import datetime >>> from babel.dates import get_timezone >>> fmt = Format('en_US', tzinfo=get_timezone('US/Eastern')) >>> fmt.datetime(datetime(2007, 4, 1, 15, 30)) u'Apr 1, 2007, 11:30:00 AM' rr)r rr)r$r/r+s r%r/zFormat.datetimeTsx DKXXXXr'time*_datetime.time | _datetime.datetime | Nonec<t|||j|jS)u-Return a time formatted according to the given pattern. >>> from datetime import datetime >>> from babel.dates import get_timezone >>> fmt = Format('en_US', tzinfo=get_timezone('US/Eastern')) >>> fmt.time(datetime(2007, 4, 1, 15, 30)) u'11:30:00 AM' r1)r rr)r$r2r+s r%r2z Format.timecs4 DKPPPPr'second333333?longFdelta_datetime.timedelta | int granularityCLiteral['year', 'month', 'week', 'day', 'hour', 'minute', 'second'] thresholdfloat,Literal['narrow', 'short', 'medium', 'long'] add_directionboolc6t||||||jS)zReturn a time delta according to the rules of the given locale. >>> from datetime import timedelta >>> fmt = Format('en_US') >>> fmt.timedelta(timedelta(weeks=11)) u'3 months' )r:r<r+r?r)rr)r$r8r:r<r+r?s r% timedeltazFormat.timedeltars, ;*3'-]'+{444 4r'numberfloat | Decimal | strc:t||j|jS)zReturn an integer number formatted for the locale. >>> fmt = Format('en_US') >>> fmt.number(1099) u'1,099' rrrrrr$rCs r%rCz Format.numbersfT[4K`aaaar' str | Nonec<t|||j|jS)zReturn a decimal number formatted for the locale. >>> fmt = Format('en_US') >>> fmt.decimal(1.2345) u'1.234' rFrGr$rCr+s r%decimalzFormat.decimal!ffT[SWShiiiir'shortr format_typeLiteral['short', 'long']fraction_digitsintc>t||||j|jS)aReturn a number formatted in compact form for the locale. >>> fmt = Format('en_US') >>> fmt.compact_decimal(123456789) u'123M' >>> fmt.compact_decimal(1234567, format_type='long', fraction_digits=2) '1.23 million' rOrQrr)rrr)r$rCrOrQs r%compact_decimalzFormat.compact_decimals/& #+;!2     r'currencyc<t|||j|jS)zHReturn a number in the given currency formatted for the locale. rF)rrr)r$rCrVs r%rVzFormat.currencys!vx VZVkllllr'Literal['short']c@t|||||j|jS)zReturn a number in the given currency formatted for the locale using the compact number format. >>> Format('en_US').compact_currency(1234567, "USD", format_type='short', fraction_digits=2) '$1.23M' rT)rrr)r$rCrVrOrQs r%compact_currencyzFormat.compact_currencys2'vx[bq.2kDLaccc cr'c<t|||j|jS)zReturn a number formatted as percentage for the locale. >>> fmt = Format('en_US') >>> fmt.percent(0.34) u'34%' rF)rrrrKs r%percentzFormat.percentrMr'c:t||j|jS)zLReturn a number formatted using scientific notation for the locale. rF)rrrrHs r% scientificzFormat.scientifics! dNcddddr'N)rrrrrrr r!)Nr()r)r*r+r,r r-)r/r*r+r,r r-)r2r3r+r,r r-)r5r6r7F) r8r9r:r;r<r=r+r>r?r@r r-)rCrDr r-)rCrDr+rIr r-)rNr)rCrDrOrPrQrRr r-)rCrDrVr-r r-) rCrDrVr-rOrXrQrRr r-)__name__ __module__ __qualname____doc__r&r)r/r2rBrCrLrUrVrZr\r^r'r%rr's  +/1 6< 111111('+.6 = = = = = +/.6 Y Y Y Y Y"<@.6 Q Q Q Q Q$\d?E# 44444(bbbbjjjjj18      ,mmmm)0 ccccc jjjjjeeeeeer'rcZeZdZUdZgdZerded<ded<ded<d ed <d ed <d ed<ddd?dZed@dZ dAdZ dBdZ dCdZ dDd Z dEd"ZdFd$ZdGd&ZdGd'ZdGd(ZdGd)ZdGd*ZdGd+ZdHd,ZdId-ZdId.ZdId/ZdId0ZdId1ZdId2ZdJd4ZdKd5ZdLd7ZdMd8Z dNd9Z!dOd:Z"dPd;Z#dQd=Z$d>S)R LazyProxyaClass for proxy objects that delegate to a specified function to evaluate the actual object. >>> def greeting(name='world'): ... return 'Hello, %s!' % name >>> lazy_greeting = LazyProxy(greeting, name='Joe') >>> print(lazy_greeting) Hello, Joe! >>> u' ' + lazy_greeting u' Hello, Joe!' >>> u'(%s)' % lazy_greeting u'(Hello, Joe!)' This can be used, for example, to implement lazy translation functions that delay the actual translation until the string is actually used. The rationale for such behavior is that the locale of the user may not always be available. In web applications, you only know the locale when processing a request. The proxy implementation attempts to be as complete as possible, so that the lazy objects should mostly work as expected, for example for sorting: >>> greetings = [ ... LazyProxy(greeting, 'world'), ... LazyProxy(greeting, 'Joe'), ... LazyProxy(greeting, 'universe'), ... ] >>> greetings.sort() >>> for greeting in greetings: ... print(greeting) Hello, Joe! Hello, universe! Hello, world! )_func_args_kwargs_value_is_cache_enabled_attribute_errorCallable[..., Any]rgztuple[Any, ...]rhzdict[str, Any]rir@rkrrjzAttributeError | NonerlT) enable_cachefuncargsrnkwargsr r!cVt|d|t|d|t|d|t|d|t|ddt|dddS)Nrgrhrirkrjrl)object __setattr__)r$rornrprqs r%r&zLazyProxy.__init__s4$///4$///4F3334!4lCCC440004!3T:::::r'c|jm |j|ji|j}n/#t$r"}t |d|d}~wwxYw|js|St |d||jS)Nrlrj)rjrgrhriAttributeErrorrsrtrk)r$valueerrors r%rwzLazyProxy.values ;  " DJ?$,??!   ""4);UCCC )    tXu 5 5 5{s! A AA keyrsc||jvSr_rwr$rys r% __contains__zLazyProxy.__contains__sdj  r'c*t|jSr_)r@rwr$s r%__bool__zLazyProxy.__bool__DJr' list[str]c*t|jSr_)dirrwrs r%__dir__zLazyProxy.__dir__4:r' Iterator[Any]c*t|jSr_)iterrwrs r%__iter__zLazyProxy.__iter__rr'rRc*t|jSr_)lenrwrs r%__len__zLazyProxy.__len__"rr'r-c*t|jSr_)r-rwrs r%__str__zLazyProxy.__str__%rr'otherc|j|zSr_r{r$rs r%__add__zLazyProxy.__add__(zE!!r'c||jzSr_r{rs r%__radd__zLazyProxy.__radd__+tz!!r'c|j|zSr_r{rs r%__mod__zLazyProxy.__mod__.rr'c||jzSr_r{rs r%__rmod__zLazyProxy.__rmod__1rr'c|j|zSr_r{rs r%__mul__zLazyProxy.__mul__4rr'c||jzSr_r{rs r%__rmul__zLazyProxy.__rmul__7rr'c|j|i|Sr_r{)r$rprqs r%__call__zLazyProxy.__call__:stz4*6***r'c|j|kSr_r{rs r%__lt__zLazyProxy.__lt__=zE!!r'c|j|kSr_r{rs r%__le__zLazyProxy.__le__@zU""r'c|j|kSr_r{rs r%__eq__zLazyProxy.__eq__Crr'c|j|kSr_r{rs r%__ne__zLazyProxy.__ne__Frr'c|j|kSr_r{rs r%__gt__zLazyProxy.__gt__Irr'c|j|kSr_r{rs r%__ge__zLazyProxy.__ge__Lrr'namec0t|j|dSr_)delattrrwr$rs r% __delattr__zLazyProxy.__delattr__Os D!!!!!r'cH|j|jt|j|Sr_)rlgetattrrwrs r% __getattr__zLazyProxy.__getattr__Rs&  ,' 'tz4(((r'rwc2t|j||dSr_)setattrrw)r$rrws r%rtzLazyProxy.__setattr__Ws D%(((((r'c|j|=dSr_r{r|s r% __delitem__zLazyProxy.__delitem__Zs JsOOOr'c|j|Sr_r{r|s r% __getitem__zLazyProxy.__getitem__]sz#r'c||j|<dSr_r{)r$ryrws r% __setitem__zLazyProxy.__setitem__`s 3r'cNt|jg|jRd|ji|jS)Nrn)rfrgrhrkrirs r%__copy__zLazyProxy.__copy__csF J Z   / l    r'memocddlm}t||j|g||j|Rd||j|i||j|S)Nr)deepcopyrn)copyrrfrgrhrkri)r$rrs r% __deepcopy__zLazyProxy.__deepcopy__ks!!!!!! HTZ & & Xdj$ ' '   !$"8$?? ht|T**    r'N) rormrprrnr@rqrr r!)r r)ryrsr r@)r r@)r r)r r)r rRr r-)rrsr r)rprrqrr r)rrsr r@)rr-r r!)rr-r r)rr-rwrr r!)ryrr r!)ryrr r)ryrrwrr r!)r rf)rrr rf)%r`rarbrc __slots__r__annotations__r&propertyrwr}rrrrrrrrrrrrrrrrrrrrrtrrrrrrdr'r%rfrfs!!Da``I0!!!! ////RV;;;;;;   X !!!!        """"""""""""""""""""""""++++""""############""""####"""")))) ))))              r'rfceZdZUer ded<ded<dZd)d*fd Zd+dZd+dZd+dZ e Z d,dZ d,dZ d,dZ e ZdZd-dZd.dZd/dZd0d Zd1d!Zd/d"Zd2d#Zd3d$ZeZd4d%Zd5d&Zd5d'ZeZd6d(ZejjZ ejj!Z"xZ#S)7NullTranslationszdict[str, str]_infozNullTranslations | None _fallbackNfp"gettext._TranslationsReader | Noner r!c i|_d|_t|t t dt |ddg|_|j|_ i|_ dS)aInitialize a simple translations class which is not backed by a real catalog. Behaves similar to gettext.NullTranslations but also offers Babel's on *gettext methods (e.g. 'dgettext()'). :param fp: a file-like object (ignored in this class) c(t|dkS)N)rR)ns r%z+NullTranslations.__init__..s#a1f++r'rNr) _catalogpluralsuperr&listfilterrfilesDEFAULT_DOMAINdomain_domains)r$r __class__s r%r&zNullTranslations.__init__}sn;= 8M8M  B&FD(A(A'BCCDD ) 57 r'rr-messagec^|j|||S)zULike ``gettext()``, but look the message up in the specified domain. )rgetgettextr$rrs r%dgettextzNullTranslations.dgettexts*}  ..66w???r'cddl}|dtd|j|||S)zVLike ``lgettext()``, but look the message up in the specified domain. rNz1ldgettext() is deprecated, use dgettext() instead stacklevel)warningswarnDeprecationWarningrrlgettext)r$rrrs r% ldgettextzNullTranslations.ldgettextsY  ?     }  ..77@@@r'c^|j|||S)zVLike ``ugettext()``, but look the message up in the specified domain. )rrugettextrs r% udgettextzNullTranslations.udgettexts*}  ..77@@@r'singularrnumrRcb|j|||||S)zVLike ``ngettext()``, but look the message up in the specified domain. )rrngettextr$rrrrs r% dngettextzNullTranslations.dngettexts.}  ..77&#NNNr'cddl}|dtd|j|||||S)zWLike ``lngettext()``, but look the message up in the specified domain. rNz3ldngettext() is deprecated, use dngettext() insteadrr)rrrrr lngettext)r$rrrrrs r% ldngettextzNullTranslations.ldngettexts]  A     }  ..8863OOOr'cb|j|||||S)zVLike ``ungettext()`` but look the message up in the specified domain. )rr ungettextrs r% udngettextzNullTranslations.udngettexts.}  ..8863OOOr'z%s%scontext str | objectc(|j||fz}t}|j||}||ur0|j||df|}||ur|S|jr|j||S|S)aLook up the `context` and `message` id in the catalog and return the corresponding message string, as an 8-bit string encoded with the catalog's charset encoding, if known. If there is no entry in the catalog for the `message` id and `context` , and a fallback has been set, the look up is forwarded to the fallback's ``pgettext()`` method. Otherwise, the `message` id is returned. r)CONTEXT_ENCODINGrsrrrrpgettext)r$rr ctxt_msg_idmissingtmsgs r%rzNullTranslations.pgettexts+w.@@ ((}  g66 7??=$$k4;;q>>%BGLLD w  K > =>**7G<< <r'str | bytes | objectcddl}|dtd|||}t |ddpt j}t|tr| |n|S)zEquivalent to ``pgettext()``, but the translation is returned in the preferred system encoding, if no other encoding was explicitly set with ``bind_textdomain_codeset()``. rNz1lpgettext() is deprecated, use pgettext() insteadrr_output_charset) rrrrrrgetpreferredencoding isinstancer-encode)r$rrrrencodings r% lpgettextzNullTranslations.lpgettexts  ?     }}Wg..4!2D99ZV=X=Z=Z(24(=(=Gt{{8$$$4Gr'c|j||fz} |j|||f}|S#t$r5|jr|j||||cYS|dkr|cYS|cYSwxYw)a^Do a plural-forms lookup of a message id. `singular` is used as the message id for purposes of lookup in the catalog, while `num` is used to determine which plural form to use. The returned message string is an 8-bit string encoded with the catalog's charset encoding, if known. If the message id for `context` is not found in the catalog, and a fallback is specified, the request is forwarded to the fallback's ``npgettext()`` method. Otherwise, when ``num`` is 1 ``singular`` is returned, and ``plural`` is returned in all other cases. r)rrrKeyErrorr npgettext)r$rrrrrrs r%rzNullTranslations.npgettexts+w.AA  =+t{{3/?/?!@ADK   ~ P~//63OOOOOaxx  s#2.A1"A1,A10A1 str | bytescddl}|dtd|j||fz} |j|||f}t |ddptj}| |S#t$r5|j r|j ||||cYS|dkr|cYS|cYSwxYw)zEquivalent to ``npgettext()``, but the translation is returned in the preferred system encoding, if no other encoding was explicitly set with ``bind_textdomain_codeset()``. rNz3lnpgettext() is deprecated, use npgettext() insteadrrr r) rrrrrrrrr r rr lnpgettext) r$rrrrrrrr s r%rzNullTranslations.lnpgettexts  A     +w.AA  =+t{{3/?/?!@ADt%6==^A\A^A^H;;x(( (   ~ Q~00(FCPPPPPaxx  sAB .C :C C C c|j||fz}t}|j||}||ur1|jr|j||St |St|t sJ|S)asLook up the `context` and `message` id in the catalog and return the corresponding message string, as a Unicode string. If there is no entry in the catalog for the `message` id and `context`, and a fallback has been set, the look up is forwarded to the fallback's ``upgettext()`` method. Otherwise, the `message` id is returned. )rrsrrr upgettextr-r )r$rrctxt_message_idrrs r%rzNullTranslations.upgettexts/7G2DD((}  ':: 7??~ B~//AAAw<< $$$$$$ r'c|j||fz} |j|||f}nZ#t$rM|jr|j||||cYS|dkrt |nt |}YnwxYw|S)a$Do a plural-forms lookup of a message id. `singular` is used as the message id for purposes of lookup in the catalog, while `num` is used to determine which plural form to use. The returned message string is a Unicode string. If the message id for `context` is not found in the catalog, and a fallback is specified, the request is forwarded to the fallback's ``unpgettext()`` method. Otherwise, when `num` is 1 `singular` is returned, and `plural` is returned in all other cases. r)rrrrr unpgettextr-)r$rrrrrrs r%rzNullTranslations.unpgettext+s/7H2EE >=/4;;s3C3C!DEDD > > >~ Q~00(FCPPPPP$'1HH3x===#f++DDD > s"1.B!$BBc`|j||||S)zVLike `pgettext()`, but look the message up in the specified `domain`. )rrrr$rrrs r% dpgettextzNullTranslations.dpgettext?s,}  ..77IIIr'c`|j||||S)zWLike `upgettext()`, but look the message up in the specified `domain`. )rrrrs r% udpgettextzNullTranslations.udpgettextEs,}  ..88'JJJr'c`|j||||S)zEquivalent to ``dpgettext()``, but the translation is returned in the preferred system encoding, if no other encoding was explicitly set with ``bind_textdomain_codeset()``. )rrrrs r% ldpgettextzNullTranslations.ldpgettextMs, }  ..88'JJJr'cd|j||||||S)zWLike ``npgettext``, but look the message up in the specified `domain`. )rrrr$rrrrrs r% dnpgettextzNullTranslations.dnpgettextTs:}  ..88(9?FF Fr'cd|j||||||S)zXLike ``unpgettext``, but look the message up in the specified `domain`. )rrrr"s r% udnpgettextzNullTranslations.udnpgettext[s:}  ..99'8:@#GG Gr'cd|j||||||S)zEquivalent to ``dnpgettext()``, but the translation is returned in the preferred system encoding, if no other encoding was explicitly set with ``bind_textdomain_codeset()``. )rrrr"s r% ldnpgettextzNullTranslations.ldnpgettextds: }  ..99'8:@#GG Gr'r_)rrr r!)rr-rr-r r-) rr-rr-rr-rrRr r-)rr-rr-r r)rr-rr-r r) rr-rr-rr-rrRr r-) rr-rr-rr-rrRr r)rr-rr-r r-)rr-rr-rr-r r)rr-rr-rr-r r-)rr-rr-rr-r r) rr-rr-rr-rr-rrRr r-) rr-rr-rr-rr-rrRr r)$r`rarbrrrr&rrr dugettextrrr dungettextrrrrrrrrr dupgettextr r#r% dunpgettextr'rrrrr __classcell__rs@r%rrus5+****N8888888"@@@@ A A A AAAAA IOOOO P P P PPPPP J"& H H H H.0"(JJJJ KKKK JKKKKFFFFGGGGKGGGG'/H(1IIIIIr'rceZdZdZdZddfd ZejjZejj Z e dddZ ddZ dddZddZxZS) Translationsz&An extended translation catalog class.messagesNrrrrIcht||p|j|_dS)zInitialize the translations catalog. :param fp: the file-like object the translation should be read from :param domain: the message domain (default: 'messages') rN)rr&rr)r$rrrs r%r&zTranslations.__init__us3 B3 3 r'dirnamestr | os.PathLike[str] | Nonelocales,Iterable[str | Locale] | Locale | str | Noner rc|s|j}tj||t|}|st St |d5}|||cdddS#1swxYwYdS)apLoad translations from the given directory. :param dirname: the directory containing the ``MO`` files :param locales: the list of locales in order of preference (items in this list can be either `Locale` objects or locale strings) :param domain: the message domain (default: 'messages') rb)rrN)rrfind_locales_to_namesropen)clsr2r4rfilenamers r%loadzTranslations.loads ('F<1B71K1KLL &#%% % (D ! ! -R3"V,,, - - - - - - - - - - - - - - - - - -s A''A+.A+r-cl|jd}dt|jd|dS)Nzproject-id-version)rrtyper`)r$versions r%__repr__zTranslations.__repr__s8*..!56664::&6676666r'T translationsmerger@cBt|d|j}|r ||jkr||S|j|}|r+t |tr||n||||j|<|S)a!Add the given translations to the catalog. If the domain of the translations is different than that of the current catalog, they are added as a catalog that is only accessible by the various ``d*gettext`` functions. :param translations: the `Translations` instance with the messages to add :param merge: whether translations for message domains that have already been added should be merged with the existing translations r) rrrrDrrr r/ add_fallback)r$rCrDrexistings r%addzTranslations.addsx1DEE  ,Vt{**::l++ +=$$V,,  1Z,77 1 NN< ( ( ( (  % %d + + +$0DM& ! r'ct|tjrS|j|jt|t r|j|j|S)a0Merge the given translations into the catalog. Message translations in the specified catalog override any messages with the same identifier in the existing catalog. :param translations: the `Translations` instance with the messages to merge )r rGNUTranslationsrupdater/rextend)r$rCs r%rDzTranslations.mergesb lG$; < < 6 M !6 7 7 7, 55 6 !!,"4555 r')NN)rrrrI)NNN)r2r3r4r5rrIr rr)T)rCr/rDr@)rCr/)r`rarbrcrr&rrJrrr classmethodr=rBrHrDr,r-s@r%r/r/ps00N4444444&.H'0I26@D! ----[-,77774r'r/r4r5r list[str] | Nonec|dSt|trt|gSt|tr|gSd|DS)zNormalize a `locales` argument to a list of locale names. :param locales: the list of locales in order of preference (items in this list can be either `Locale` objects or locale strings) Nc,g|]}t|Srd)r-).0rs r% z%_locales_to_names..s . . .FCKK . . .r')r r r-)r4s r%r9r9s\t'6""G ~'3y . .g . . ..r')r4r5r rN)'rc __future__rrroscollections.abcrtypingrrrrr babel.corer babel.datesr r r r babel.numbersrrrrrrr/ _datetimerLrrrrfrrJr/r9rdr'r%r[s1  #""""" $$$$$$BBBBBBBBBBBBBBSSSSSSSSSSSS2    111111heheheheheheheheV` ` ` ` ` ` ` ` Fx2x2x2x2x2w/x2x2x2vTTTTT#W%<TTTn//////r'