MhRtdZddlZddlZddlZddlZddlZddlZddlZddlm Z ddl m Z ddl m Z ddlmZmZmZmZmZdaiaet(gadad Zd ed d fd Zded dfdZddedeed dfdZdeded dfdZd eefdZGdd Z Gdde Z!Gdde Z"dS)aTranslation methods for generating localized strings. To load a locale and generate a translated string:: user_locale = tornado.locale.get("es_LA") print(user_locale.translate("Sign out")) `tornado.locale.get()` returns the closest matching locale, not necessarily the specific locale you requested. You can support pluralization with additional arguments to `~Locale.translate()`, e.g.:: people = [...] message = user_locale.translate( "%(list)s is online", "%(list)s are online", len(people)) print(message % {"list": user_locale.list(people)}) The first string is chosen if ``len(people) == 1``, otherwise the second string is chosen. Applications should call one of `load_translations` (which uses a simple CSV format) or `load_gettext_translations` (which uses the ``.mo`` format supported by `gettext` and related tools). If neither method is called, the `Locale.translate` method will simply return the original string. N)escape)gen_log) LOCALE_NAMES)IterableAnyUnionDictOptionalen_USF locale_codesreturnLocalectj|S)aReturns the closest match for the given locale codes. We iterate over all given locale codes in order. If we have a tight or a loose match for the code (e.g., "en" for "en_US"), we return the locale. Otherwise we move to the next code in the list. By default we return ``en_US`` if no translations are found for any of the specified locales. You can change the default locale with `set_default_locale()`. )r get_closest)r s N/var/www/html/test/jupyter/venv/lib/python3.11/site-packages/tornado/locale.pygetr>s  | ,,codec|attttgzadS)a7Sets the default locale. The default locale is assumed to be the language used for all strings in the system. The translations loaded from disk are mappings from the default locale to the destination locale. Consequently, you don't need to create a translation file for the default locale. N)_default_locale frozensetlist _translationskeys_supported_locales)rs rset_default_localerLs9O"4 (:(:(<(<#=#=@Q#QRRr directoryencodingc iatj|D]}|ds|d\}}t jd|s5tjd|tj ||{tj ||}|st|d5}| ttj}dddn #1swxYwY|tjtjfvrd}nd}t|| 5}it|<t#t%j|D]\} } | rt| d krd | D} | dd \} } t| d kr | d pd } nd } | d vrtjd| || dzs| t|| i| < dddn #1swxYwYt+t-tt0gzatjdt7t2dS)uwLoads translations from CSV files in a directory. Translations are strings with optional Python-style named placeholders (e.g., ``My name is %(name)s``) and their associated translations. The directory should have translation files of the form ``LOCALE.csv``, e.g. ``es_GT.csv``. The CSV files should have two or three columns: string, translation, and an optional plural indicator. Plural indicators should be one of "plural" or "singular". A given string can have both singular and plural forms. For example ``%(name)s liked this`` may have a different verb conjugation depending on whether %(name)s is one name or a list of names. There should be two rows in the CSV file for that string, one with plural indicator "singular", and one "plural". For strings with no verbs that would change on translation, simply use "unknown" or the empty string (or don't include the column at all). The file is read using the `csv` module in the default "excel" dialect. In this format there should not be spaces after the commas. If no ``encoding`` parameter is given, the encoding will be detected automatically (among UTF-8 and UTF-16) if the file contains a byte-order marker (BOM), defaulting to UTF-8 if no BOM is present. Example translation ``es_LA.csv``:: "I love you","Te amo" "%(name)s liked this","A %(name)s les gustó esto","plural" "%(name)s liked this","A %(name)s le gustó esto","singular" .. versionchanged:: 4.3 Added ``encoding`` parameter. Added support for BOM-based encoding detection, UTF-16, and UTF-8-with-BOM. z.csv.z[a-z]+(_[A-Z]+)?$z!Unrecognized locale %r (path: %s)Nrbzutf-16z utf-8-sig)rcZg|](}tj|)S)r to_unicodestrip).0cs r z%load_translations..s/AAAv(++1133AAArunknown)pluralsingularr+z.Unrecognized plural indicator %r in %s line %dSupported locales: %s)roslistdirendswithsplitrematchrerrorpathjoinopenreadlencodecs BOM_UTF16_LE BOM_UTF16_BE enumeratecsvreader setdefaultrrrrrdebugsorted)rrr7locale extension full_pathbfdatafirowenglish translationr,s rload_translationsrOZsJM 9%%,T,T}}V$$   JJsOO x+V44  M3 Y--    GLLD11  i&& 9"wws6#67788 9 9 9 9 9 9 9 9 9 9 9 9 9 9 9+V-@AAA# ')h / / / T1$&M& !#CJqMM22 T T3c#hhllAASAAA'*2A2w$s88a<< V0yFF&F!BBBMHA  HS f%00< new.po 3. Compile:: msgfmt mydomain.po -o {directory}/pt_BR/LC_MESSAGES/mydomain.mo * LC_MESSAGESz.mo) languagesz$Cannot load translation for '%s': %sNTr/)rglobr0r7r8basenamedirnamegettextrN Exceptionrr6strrrrrr _use_gettextrCrD)rrPfilenamelanges rload_gettext_translationsr_s90MI  Y]FUNCC  w0I0I J JKK ")"5 dV###M$      M@$A O O O HHHH #4 (:(:(<(<#=#=@Q#QRRL M)62D+E+EFFFFFs B77 C.#C))C.ctS)z1Returns a list of all the supported locale codes.)rr%rrget_supported_localesras rc beZdZdZiZededdfdZededdfdZdeddfdZ dd ed e ed e e defd Z dd ed ed e ed e e def dZ ddee eejfde dedededef dZ d dejde dedefdZdedefdZde defdZdS)!rzObject representing a locale. After calling one of `load_translations` or `load_gettext_translations`, call `get` or `get_closest` to get a Locale object. r rc>|D]}|s|dd}|d}t|dkrEt|dkr8|ddz|dz}|t vr||cS|dt vr/||dcS|tS)z4Returns the closest match for the given locale code.-_r#rr.)replacer3r;lowerupperrrr)clsr rpartss rrzLocale.get_closests! 1 1D <<S))DJJsOOE5zzA~~UqQx~~''#-a0@0@@)))wwt}}$$$Qx~~#555wwuQx~~//000006ww'''rrc||jvrk|tvsJt|d}|t |i}n(t rt ||}nt ||}||j|<|j|S)znReturns the Locale for the given locale code. If it is not supported, we raise an exception. N)_cacherrr CSVLocaler[ GettextLocale)rir translationsrEs rrz Locale.gets sz ! !-----(,,T488L#"4,, 7&t\::"466%CJt z$rNct||_tj|idd|_d|_dD]%}|j|r d|_n&|j}|d|d|d|d |d |d |d |d |d|d|d|dg |_|d|d|d|d|d|d|dg|_dS)NnameUnknownF)faarheTJanuaryFebruaryMarchAprilMayJuneJulyAugust SeptemberOctoberNovemberDecemberMondayTuesday WednesdayThursdayFridaySaturdaySunday) rrrrqrtl startswith translate_months _weekdays)selfrprefixres r__init__zLocale.__init__ s^  $T2..2269EE (  Fy##F++   N AiLL AjMM AgJJ AgJJ AeHH AfII AfII AhKK AkNN AiLL AjMM AjMM    AhKK AiLL AkNN AjMM AhKK AjMM AhKK rmessageplural_messagecountct)a&Returns the translation for the given message for this locale. If ``plural_message`` is given, you must also provide ``count``. We return ``plural_message`` when ``count != 1``, and we return the singular form for the given message when ``count == 1``. NotImplementedErrorrrrrs rrzLocale.translate0s"###rcontextctNrrrrrrs rpgettextzLocale.pgettext?s"###rrTFdate gmt_offsetrelativeshorter full_formatct|ttfr/tj|tjj}|j%|tjj}tj tjj}||kr|r||z j dkr|}nd}|tj |z }|tj |z }|tj dz } ||z } | j } | j } |j } d}|s|rl| dkrf| d kr| d d | d | izS| d kr$t| dz }| dd|d|izSt| dz }| dd|d|izS| dkr | d}nn| dkr+|j| jkr|r|r | dn | d}n=| dkr|r | dn | d}n| dkr|r | dn | d}||r | d n | d!}|jd"v}|rd#|j|jfz}nX|jd$kr'd%d&|jd'k|jd'zpd'|jfz}n&d(|jd'zpd'|jd)|jd'kfz}||j|jdz |j|t/|jt/|j|d*zS)+a)Formats the given date. By default, we return a relative time (e.g., "2 minutes ago"). You can return an absolute date string with ``relative=False``. You can force a full format date ("July 10, 1980") with ``full_format=True``. This method is primarily intended for dates in the past. For dates in the future, we fall back to full format. .. versionchanged:: 6.4 Aware `datetime.datetime` objects are now supported (naive datetimes are still assumed to be UTC). N)tzinfo<Tminutes)hoursr2z 1 second agoz%(seconds)d seconds agosecondsi gN@z 1 minute agoz%(minutes)d minutes agorg @z 1 hour agoz%(hours)d hours agorz%(time)sr. yesterdayzyesterday at %(time)sz %(weekday)sz%(weekday)s at %(time)siN%(month_name)s %(day)sz"%(month_name)s %(day)s at %(time)sz %(month_name)s %(day)s, %(year)sz,%(month_name)s %(day)s, %(year)s at %(time)s)enr zh_CNz%d:%02drz %s%d:%02d)u上午u下午 z %d:%02d %s)ampm) month_nameweekdaydayyeartime) isinstanceintfloatdatetime fromtimestamptimezoneutcrrfnowr timedeltadaysrroundrrhourminutermonthrrrZr)rrrrrrr local_date local_nowlocal_yesterday differencerrreformatrr tfhour_clockstr_times r format_datezLocale.format_dateHs. dS%L ) ) P$2249J9NOOD ; <G4555QEFF  y(@@   JOZ5F#GGHH Y' ! !"0B1FG"$*!&HH $"$*!Z_23'H ,z'7!';<~j&8&8&:&:;z~&& ((     rdowcX|tj|z }|j}|rT|d|j|jdz |j|t|jdzS|d|j|jdz t|jdzS)zFormats the given date as a day of week. Example: "Monday, January 22". You can remove the day of week with ``dow=False``. rz#%(weekday)s, %(month_name)s %(day)sr.)rrrr)rr) rrrrrrrrZr)rrrrrres r format_dayzLocale.format_daysH.zBBBB N  1:;;"l:+;a+?@>**<*<*>*>?:>**??  1-.."l:+;a+?@:>**22 rrjc0|j}t|dkrdSt|dkr|dS|jdrdnd}|d||dd |t|dz d zS) zReturns a comma-separated list for the given list of parts. The format is, e.g., "A, B and C", "A and B" or just "A" for lists of size 1. rr.rsu و z, z%(commas)s and %(last)sN)commaslast)rr;rrr8)rrjrecommas rrz Locale.lists N u::??2 u::??8O"i22488B dq*++jjss,,#e**q.)/ /   rvaluec|jdvrt|St|}g}|r)||dd|dd}|)dt |S)z7Returns a comma-separated number for the given integer.)rr N,)rrZappendr8reversed)rrsrjs rfriendly_numberzLocale.friendly_numbers~ 9O + +u::  JJ  LL233 #2#A xx(((rNN)rTFF)rT)__name__ __module__ __qualname____doc__rl classmethodrZrrrr rrrrrrboolrrrrrr%rrrrsM F((((([(" s x   [ "! S! T! ! ! ! L)-# $ $ $!  $} $ $ $ $ $&)-# $$$$! $ } $ $$$$! h h C 112h h  h  h  h  h h h h VIM%36AE , # #    " )S )S ) ) ) ) ) )rc eZdZdZdedeeeeeffddffd Z d dedeed eedefd Z d d ededeed eedef d Z xZ S)rmz=Locale implementation using tornado's CSV translation format.rrorNcX||_t|dSr)rosuperrrrro __class__s rrzCSVLocale.__init__s)( rrrrc|D|J|dkr|}|jdi}n7|jdi}n|jdi}|||S)Nr.r,r-r+)ror)rrrr message_dicts rrzCSVLocale.translates  %$$$zz(#044XrBB #044ZDD ,00B??L111rrcf|jrtjd||||S)Nz&pgettext is not supported by CSVLocale)rorwarningrrs rrzCSVLocale.pgettexts7   F OD E E E~~g~u===rr) rrrrrZr rr rrr __classcell__rs@rrmrmsGGSS$sCx.5H0Id)-# 222! 2} 2 2222*)-# > > > >! > } > > > > > > > > >rrmc eZdZdZdedejddffd Z d dedeed ee defd Z d d ededeed ee def d Z xZ S)rnz1Locale implementation using the `gettext` module.rrorNcz|j|_|j|_t|dSr)ngettextrXrrrs rrzGettextLocale.__init__ s7$- #+  rrrrcf||J||||S||Sr)rrXrs rrzGettextLocale.translates>  %$$$==.%@@ @<<(( (rrc|K|J|t||t||f}|j|}t|vr||||}|S|t|}||}t|vr|}|S)a?Allows to set context for translation, accepts plural forms. Usage example:: pgettext("law", "right") pgettext("good", "right") Plural message example:: pgettext("organization", "club", "clubs", len(clubs)) pgettext("stick", "club", "clubs", len(clubs)) To generate POT file with context, add following options to step 1 of `load_gettext_translations` sequence:: xgettext [basic options] --keyword=pgettext:1c,2 --keyword=pgettext:1c,2,3 .. versionadded:: 4.2 )CONTEXT_SEPARATORrrX)rrrrrmsgs_with_ctxtresult msg_with_ctxts rrzGettextLocale.pgettexts4  %$$$8-8w88?-?~??N #T]N3F F**wFFM&D(9D7DDM\\-00F F** Mrr) rrrrrZrXNullTranslationsrr rrrrrs@rrnrn s;;S0HT)-# ) ) )!  )} ) ) ) ) ) )-# ,,,,! , } , ,,,,,,,,rrnr)#rr<r@rrXrUr0r4tornador tornado.logrtornado._locale_datartypingrrrr r rrrrr[rrZrrrOr_rarrmrnr%rrrsO2  ------77777777777777 Y011  -s -x - - - - SS ST S S S STGTGTG TGTGTGTGTGn'G'Gc'Gd'G'G'G'GTx} B)B)B)B)B)B)B)B)J!>!>!>!>!>!>!>!>HBBBBBFBBBBBr