ƪb2dZddlZddlmZddlmZddlmZmZddl m Z ddl m Z ddl m Z dd lmZdd lmZmZdd lmZdd lmZdd lmZmZmZmZgdZej<dej>Z dZ!GddZ"Gdde#Z$dZ%GddZ&y)z babel.messages.catalog ~~~~~~~~~~~~~~~~~~~~~~ Data structures for message catalogs. :copyright: (c) 2013-2022 by the Babel Team. :license: BSD, see LICENSE for more details. N) parse_header) OrderedDict)datetimetime)get_close_matches)message_from_string)copy) __version__)LocaleUnknownLocaleError)format_datetime) get_plural)distinctLOCALTZFixedOffsetTimezone_cmp)MessageCatalogTranslationErrorz \% (?:\(([\w]*)\))? ( [-#0\ +]?(?:\*|[\d]+)? (?:\.(?:\*|[\d]+))? [hlL]? ) ([diouxXeEfFgGcrs%]) cjtjd|}tj|j dd}|j d}|d|d|dd}}|dd|dd}}t |dz}t |} t |} | d z} | | z } | |z} t | }|j| }|S) Nz+^(?P.*?)(?P[+-]\d{4})?$rz%Y-%m-%d %H:%Mtzoffsetr1<tzinfo)rematchrstrptimegroupintrreplace) valuerdtr plus_minus_sresthours_offset_s mins_offset_s plus_minus hours_offset mins_offsetnet_mins_offsets 8/usr/lib/python3/dist-packages/babel/messages/catalog.py_parse_datetime_headerr/)s HHCU KE   5;;z24D EB{{:&H%a[(12,d (,Ra$qr( +, >* -( '+;&:%'7ZZxZ ( IceZdZdZ ddZdZdZdZdZdZ d Z d Z d Z d Z d ZddZedZedZedZy)rz0Representation of a single message in a catalog.Nc ||_|s|jrd}||_tt ||_t ||_|r(|jr|jjdn|jjdtt ||_ tt ||_ t|tr |g|_nt||_||_| |_y)a_Create the message object. :param id: the message ID, or a ``(singular, plural)`` tuple for pluralizable messages :param string: the translated message string, or a ``(singular, plural)`` tuple for pluralizable messages :param locations: a sequence of ``(filename, lineno)`` tuples :param flags: a set or sequence of flags :param auto_comments: a sequence of automatic comments for the message :param user_comments: a sequence of user comments for the message :param previous_id: the previous message ID, or a ``(singular, plural)`` tuple for pluralizable messages :param lineno: the line number on which the msgid line was found in the PO file, if any :param context: the message context )r3z python-formatN)id pluralizablestringlistr locationssetflags python_formatadddiscard auto_comments user_comments isinstancestr previous_idlinenocontext) selfr4r6r8r:r>r?rBrCrDs r.__init__zMessage.__init__Js$$++F hy12Z $$$ JJNN? + JJ   /!(="9:!(="9: k3 ' +}D #K0D   r0czdt|jd|jdt|jdS)N< z (flags: z)>)type__name__r4r7r:rEs r.__repr__zMessage.__repr__os+(,T (;(;TWW(,TZZ(8: :r0c8d}t||||S)z0Compare Messages, taking into account plural idsct|tr+|jr|jd|jxsdfS|j|jxsdfS)Nrr3)r@rr5r4rD)objs r.values_to_comparez*Message.__cmp__..values_to_compareusH#w'C,<,<vvay#++"333663;;,", ,r0)r)rEotherrQs r.__cmp__zMessage.__cmp__ss" -%d+->u-EFFr0c*|j|dkDSNrrSrErRs r.__gt__zMessage.__gt__{||E"Q&&r0c*|j|dkSrUrVrWs r.__lt__zMessage.__lt__~rYr0c*|j|dk\SrUrVrWs r.__ge__zMessage.__ge__||E"a''r0c*|j|dkSrUrVrWs r.__le__zMessage.__le__r^r0c*|j|dk(SrUrVrWs r.__eq__zMessage.__eq__r^r0c*|j|dk7SrUrVrWs r.__ne__zMessage.__ne__r^r0cXt|tsJ|j|jk(S)z[Checks whether messages are identical, taking into account all properties. )r@r__dict__rWs r. is_identicalzMessage.is_identicals'%)))}}..r0cttt|j|j|j |j |j|j|j|j|jf SN) rmapr r4r6r8r:r>r?rBrCrDrLs r.clonez Message.clones^D477DKK#'::t/A/A#'#5#5t7G7G#';; #>?@ @r0cddlm}g}|D] } ||||S#t$r}|j|Yd}~0d}~wwxYw)aRun various validation checks on the message. Some validations are only performed if the catalog is provided. This method returns a sequence of `TranslationError` objects. :rtype: ``iterator`` :param catalog: A catalog instance that is passed to the checkers :see: `Catalog.check` for a way to perform checks for all messages in a catalog. r)checkersN)babel.messages.checkersrmrappend)rEcatalogrmerrorscheckeres r.checkz Message.checksR 5 !G !& !  $ ! a   !s  A;Acd|jvS)aWhether the translation is fuzzy. >>> Message('foo').fuzzy False >>> msg = Message('foo', 'foo', flags=['fuzzy']) >>> msg.fuzzy True >>> msg :type: `bool`fuzzyr:rLs r.rvz Message.fuzzys$**$$r0cBt|jttfS)zWhether the message is plurizable. >>> Message('foo').pluralizable False >>> Message(('foo', 'bar')).pluralizable True :type: `bool`)r@r4r7tuplerLs r.r5zMessage.pluralizables$''D%=11r0cp|j}t|ttfs|g}t d|DS)zWhether the message contains Python-style parameters. >>> Message('foo %(name)s bar').python_format True >>> Message(('foo %(name)s', 'foo %(name)s')).python_format True :type: `bool`c3FK|]}tj|ywri) PYTHON_FORMATsearch).0r4s r. z(Message.python_format..s:=''+:s!)r4r@r7ryany)rEidss r.r;zMessage.python_formats3gg#e}-%C:c:::r0)r3rrrrNNri)rK __module__ __qualname____doc__rFrMrSrXr[r]r`rbrdrgrkrtpropertyrvr5r;rr0r.rrGs:MOHL#J:G''((((/@ & % % 2 2 ; ;r0rceZdZdZy)rz_Exception thrown by translation checkers when invalid message translations are encountered.N)rKrrrrr0r.rrs%r0rz# Translations template for PROJECT. # Copyright (C) YEAR ORGANIZATION # This file is distributed under the same license as the PROJECT project. # FIRST AUTHOR , YEAR. #c DeZdZdZddeddddddddddf dZdZdZdZe eeZ e eZ dZ d Z e e e d Zd Zd!d ZdZe eed Ze dZe dZe dZdZdZdZdZdZdZdZ d"dZdZd#dZd#dZ d$dZ!d#dZ"d Z#y)%rz$Representation of a message catalog.NTcX||_||_||_t|_|xsd|_|xsd|_|xsd|_|xsd|_| xsd|_ | xsd|_ | xsd|_ |tjt}n2t|tr"|j s|j#t }||_| d } n2t| tr"| j s| j#t } | |_| |_t|_d|_d|_y) aDInitialize the catalog object. :param locale: the locale identifier or `Locale` object, or `None` if the catalog is not bound to a locale (which basically means it's a template) :param domain: the message domain :param header_comment: the header comment as string, or `None` for the default header :param project: the project's name :param version: the project's version :param copyright_holder: the copyright holder of the catalog :param msgid_bugs_address: the email address or URL to submit bug reports to :param creation_date: the date the catalog was created :param revision_date: the date the catalog was revised :param last_translator: the name and email of the last translator :param language_team: the name and email of the language team :param charset: the encoding to use in the output (defaults to utf-8) :param fuzzy: the fuzzy bit on the catalog header PROJECTVERSION ORGANIZATIONz EMAIL@ADDRESSzFULL NAME zLANGUAGE utf-8NrzYEAR-MO-DA HO:MI+ZONE)domainlocale_header_commentr _messagesprojectversioncopyright_holdermsgid_bugs_addresslast_translator language_teamcharsetrnowrr@rr# creation_date revision_datervobsolete _num_plurals _plural_expr)rErrheader_commentrrrrrrrrrrvs r.rFzCatalog.__init__s2  -$+) +) 0 BN"4"G.M2M<*D.D:)'  $LL1M  x 09M9M)111AM*  3M  x 09M9M)111AM* #    r0c4|d|_d|_yt|trt ||_||_yt|tr,t ||_ tj ||_ytd|z#t $r d|_YywxYw)NzF`locale` must be a Locale, a locale identifier string, or None; got %r)_locale_identifier_localer@r rAparser TypeErrorrErs r. _set_localezCatalog._set_locale"s >&*D #DL  ff %&)&kD #!DL  fc "&)&kD # $%||F3  `ciijj & $#  $sBBBc|jSri)rrLs r. _get_localezCatalog._get_locale7s ||r0c|jSri)rrLs r._get_locale_identifierzCatalog._get_locale_identifier:s&&&r0c|j}tjtj d}t |j dr|j j d}|jd|jjd|jjd|jd|j}|jr|jjn |j}|r|jdd|z}|S) Nz%YstrftimerrYEARrzTranslations templatez%s translations)rrrrrhasattrrr#rrrr english_namelocale_identifier)rEcommentyear locale_names r._get_header_commentzCatalog._get_header_comment@s&&||G$--d3 4%%z 2%%..t4D//)T\\:!')T\\:!'&$/!'.$2G2GH 48;;t{{//DDZDZ oo&=?PS^?^_Gr0c||_yri)r)rEr6s r._set_header_commentzCatalog._set_header_commentNs %r0a The header comment for the catalog. >>> catalog = Catalog(project='Foobar', version='1.0', ... copyright_holder='Foo Company') >>> print(catalog.header_comment) #doctest: +ELLIPSIS # Translations template for Foobar. # Copyright (C) ... Foo Company # This file is distributed under the same license as the Foobar project. # FIRST AUTHOR , .... # The header can also be set from a string. Any known upper-case variables will be replaced when the header is retrieved again: >>> catalog = Catalog(project='Foobar', version='1.0', ... copyright_holder='Foo Company') >>> catalog.header_comment = '''\ ... # The POT for my really cool PROJECT project. ... # Copyright (C) 1990-2003 ORGANIZATION ... # This file is distributed under the same license as the PROJECT ... # project. ... #''' >>> print(catalog.header_comment) # The POT for my really cool Foobar project. # Copyright (C) 1990-2003 Foo Company # This file is distributed under the same license as the Foobar # project. # :type: `unicode` )docc hg}|jd|jd|jf|jd|jf|jdt |j ddft |jttttfr*|jdt |jddfn|jd|jf|jd |jf|jr&|jd t|jf|jrOd |jvrA|jd |jj!d t|jfn|jd |jf|j"|jd |j$f|jd|jdd|j&zf|jd|jddt(zf|S)NzProject-Id-VersionrIzReport-Msgid-Bugs-TozPOT-Creation-Datezyyyy-MM-dd HH:mmZen)rzPO-Revision-DatezLast-TranslatorLanguageLANGUAGEz Language-Teamz Plural-Forms)z MIME-Versionz1.0z Content-Typeztext/plain; charset=%s)zContent-Transfer-Encoding8bitz Generated-Byz Babel %s )rorrrr rr@rrtime_r"floatrrrArr#r plural_formsrr)rEheaderss r._get_mime_headerszCatalog._get_mime_headersrs,#'<<>@ A.0G0GHI+'(:(:,>,?NO P NN.0B0BC D)4+?+?@A  ! ! NNJD,B,B(CD E  ! !zT5G5G'G NNO ..66z7:4;Q;Q7RTU V NNOT-?-?@ A ;; " NNND,=,=> ?./04<<?A B<= w(>?@r0ct|tr|St|tr|j||St|Sri)r@rAbytesdecode)rEsencodingrqs r. _force_textzCatalog._force_texts5 a H a 88Hf- -1v r0c*|D]\}}|j|j|j}|j||j}|dk(r5|jd}dj |dd|_|d|_|dk(r||_|dk(r||_|dk(r$|jdd }|j||d k(r||_ |d k(r-t|\}}d |vs|d j|_ |d k(rJtd|z\}}t|jdd|_|jdd|_Z|dk(rt#||_q|dk(sxd|vs~t#||_y)N)rzproject-id-versionrIzreport-msgid-bugs-tozlast-translatorlanguage-_z language-teamz content-typerz plural-formsz ;npluralsrplural(n != 1)zpot-creation-datezpo-revision-dater)rlowerrsplitjoinrrrrr#rrrr"getrrr/rr)rErnamer$partsmimetypeparamsrs r._set_mime_headerszCatalog._set_mime_headerss" GKD%##DJJL4<<#HD$$UT\\$BE++ C(#yys4 $Ry //*/'**',$# c3/  '(%*"'#/#6 &&#))#4#:#:#>> from babel.dates import UTC >>> created = datetime(1990, 4, 1, 15, 30, tzinfo=UTC) >>> catalog = Catalog(project='Foobar', version='1.0', ... creation_date=created) >>> for name, value in catalog.mime_headers: ... print('%s: %s' % (name, value)) Project-Id-Version: Foobar 1.0 Report-Msgid-Bugs-To: EMAIL@ADDRESS POT-Creation-Date: 1990-04-01 15:30+0000 PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE Last-Translator: FULL NAME Language-Team: LANGUAGE MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Generated-By: Babel ... And here's an example of the output when the locale is set: >>> revised = datetime(1990, 8, 3, 12, 0, tzinfo=UTC) >>> catalog = Catalog(locale='de_DE', project='Foobar', version='1.0', ... creation_date=created, revision_date=revised, ... last_translator='John Doe ', ... language_team='de_DE ') >>> for name, value in catalog.mime_headers: ... print('%s: %s' % (name, value)) Project-Id-Version: Foobar 1.0 Report-Msgid-Bugs-To: EMAIL@ADDRESS POT-Creation-Date: 1990-04-01 15:30+0000 PO-Revision-Date: 1990-08-03 12:00+0000 Last-Translator: John Doe Language: de_DE Language-Team: de_DE Plural-Forms: nplurals=2; plural=(n != 1); MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Generated-By: Babel ... :type: `list` c|j-d}|jrt|jd}||_|jS)zThe number of plurals used by the catalog or locale. >>> Catalog(locale='en').num_plurals 2 >>> Catalog(locale='ga').num_plurals 5 :type: `int`rr)rrr)rEnums r. num_pluralszCatalog.num_pluralssC    $C{{ -a0 #D    r0c|j-d}|jrt|jd}||_|jS)aWThe plural expression used by the catalog or locale. >>> Catalog(locale='en').plural_expr '(n != 1)' >>> Catalog(locale='ga').plural_expr '(n==1 ? 0 : n==2 ? 1 : n>=3 && n<=6 ? 2 : n>=7 && n<=10 ? 3 : 4)' >>> Catalog(locale='ding').plural_expr # unknown locale '(n != 1)' :type: `str`rr)rrr)rEexprs r. plural_exprzCatalog.plural_exprsC    $D{{!$++.q1 $D    r0c<d|jd|jdS)zReturn the plural forms declaration for the locale. >>> Catalog(locale='en').plural_forms 'nplurals=2; plural=(n != 1);' >>> Catalog(locale='pt_BR').plural_forms 'nplurals=2; plural=(n > 1);' :type: `str`z nplurals=z ; plural=;)rrrLs r.rzCatalog.plural_formss-1,<,N>NOOr0c<|j||jvS)z?Return whether the catalog has a message with the specified ID._key_forrrEr4s r. __contains__zCatalog.__contains__s}}R DNN22r0c,t|jS)zeThe number of messages in the catalog. This does not include the special ``msgid ""`` entry.)lenrrLs r.__len__zCatalog.__len__ s4>>""r0c#Kg}|jD]\}}|j|d|t}|jr|dhz}t ddj |||j D]}|j |yw)zIterates through all the entries in the catalog, in the order they were added, yielding a `Message` object for every entry. :rtype: ``iterator``z: rvr3 rwN) mime_headersror9rvrrr)rEbufrr$r:keys r.__iter__zCatalog.__iter__&s ,, 1KD% JJ4/ 0 1 :: gY Ec499S>77>> &C..% % &sB B cd}|jrd|jz}dt|jd|j|dS)Nr3z %srHrI>)rrJrKrrs r.rMzCatalog.__repr__5s8 ;;T[[(F"4j114;;GGr0c&|j|y)z)Delete the message with the specified ID.N)deleters r. __delitem__zCatalog.__delitem__;s  Br0c$|j|S)zUReturn the message with the specified ID. :param id: the message ID )rrs r. __getitem__zCatalog.__getitem__?s xx|r0cFt|tsJd|j||j}|jj |}|r|j r.|j s"|j|_|j|_tt|j|jz|_ tt|j|jz|_ tt|j|jz|_ |xj|jzc_|}y|dk(ryt|jj!|_dj%|jDcgc]}d|zj'c}|_|j*|_yt|tt,fr=t|jtt,fsJdt/|jz||j|<ycc}w)aAdd or update the message with the specified ID. >>> catalog = Catalog() >>> catalog[u'foo'] = Message(u'foo') >>> catalog[u'foo'] If a message with that ID is already in the catalog, it is updated to include the locations and flags of the new message. >>> catalog = Catalog() >>> catalog[u'foo'] = Message(u'foo', locations=[('main.py', 1)]) >>> catalog[u'foo'].locations [('main.py', 1)] >>> catalog[u'foo'] = Message(u'foo', locations=[('utils.py', 5)]) >>> catalog[u'foo'].locations [('main.py', 1), ('utils.py', 5)] :param id: the message ID :param message: the `Message` object zexpected a Message objectr3rz# %szExpected sequence but got %sN)r@rrrDrrr5r4r6r7rr8r>r?r:ritemsrrrstriprrvryrJ)rEr4messagercurrentcs r. __setitem__zCatalog.__setitem__Fs,'7+H-HH+mmB0..$$S) ##G,@,@$ZZ !( $Xg.?.?.5.?.?/@&A!BG $('2G2G292G2G3H*I%JG !$('2G2G292G2G3H*I%JG ! MMW]] *MG 2X 3GNN C I I KD "&))070E0E-Gqfqj-@-@-B-G#HD  DJ"tUm,!'..4-@J2T'..5IIJ@")DNN3 -GsHc Jt||t|||||||  } | ||<| S)atAdd or update the message with the specified ID. >>> catalog = Catalog() >>> catalog.add(u'foo') >>> catalog[u'foo'] This method simply constructs a `Message` object with the given arguments and invokes `__setitem__` with that object. :param id: the message ID, or a ``(singular, plural)`` tuple for pluralizable messages :param string: the translated message string, or a ``(singular, plural)`` tuple for pluralizable messages :param locations: a sequence of ``(filename, lineno)`` tuples :param flags: a set or sequence of flags :param auto_comments: a sequence of automatic comments :param user_comments: a sequence of user comments :param previous_id: the previous message ID, or a ``(singular, plural)`` tuple for pluralizable messages :param lineno: the line number on which the msgid line was found in the PO file, if any :param context: the message context )rCrD)rr7) rEr4r6r8r:r>r?rBrCrDrs r.r<z Catalog.addxs66"fd9oum'V")+Rr0c#K|jjD]}|j|}|s||fyw)aBRun various validation checks on the translations in the catalog. For every message which fails validation, this method yield a ``(message, errors)`` tuple, where ``message`` is the `Message` object and ``errors`` is a sequence of `TranslationError` objects. :rtype: ``iterator`` )rpN)rvaluesrt)rErrqs r.rtz Catalog.checksA~~,,. &G]]4]0Fvo% &s2> >cX|jj|j||S)zReturn the message with the specified ID and context. :param id: the message ID :param context: the message context, or ``None`` for no context )rrr)rEr4rDs r.rz Catalog.gets$ ~~!!$--G"<==r0c`|j||}||jvr|j|=yy)zDelete the message with the specified ID and context. :param id: the message ID :param context: the message context, or ``None`` for no context NrrEr4rDrs r.rzCatalog.deletes1 mmB( $.. s# !r0c*jjt_g}|s=Dcic]2}|r.|jrj ||j 4}}t fd}|D]}|jsj |j|j } | vr ||| | E|slt| tr| d} n| } t| jj|jd} | r| d} || } | | | f} ||| | ||j<D]}|s|vs |j|<|r|j_|j _ycc}w)aUpdate the catalog based on the given template catalog. >>> from babel.messages import Catalog >>> template = Catalog() >>> template.add('green', locations=[('main.py', 99)]) >>> template.add('blue', locations=[('main.py', 100)]) >>> template.add(('salad', 'salads'), locations=[('util.py', 42)]) >>> catalog = Catalog(locale='de_DE') >>> catalog.add('blue', u'blau', locations=[('main.py', 98)]) >>> catalog.add('head', u'Kopf', locations=[('util.py', 33)]) >>> catalog.add(('salad', 'salads'), (u'Salat', u'Salate'), ... locations=[('util.py', 38)]) >>> catalog.update(template) >>> len(catalog) 3 >>> msg1 = catalog['green'] >>> msg1.string >>> msg1.locations [('main.py', 99)] >>> msg2 = catalog['blue'] >>> msg2.string u'blau' >>> msg2.locations [('main.py', 100)] >>> msg3 = catalog['salad'] >>> msg3.string (u'Salat', u'Salate') >>> msg3.locations [('util.py', 42)] Messages that are in the catalog but not in the template are removed from the main collection, but can still be accessed via the `obsolete` member: >>> 'head' in catalog False >>> list(catalog.obsolete.values()) [] :param template: the reference catalog, usually read from a POT file :param no_fuzzy_matching: whether to use fuzzy matching of message IDs c4|j}d}||k7rld}j|j|}t|jt r|jg|_n-t|j|_nj|d}|j|_ r#tt|j|_ t|jttfrt|jttfs;d}t|jgdgt|jdz zz|_ nt|j jk7rid}t|jdt|j|_ n6t|jttfrd}|jd|_ |xj|jzc_|r|xjdhzc_| |j<y)NFTr3rrrv)rkr<rr@r4rArBr7popr6rr?ryrrr:) roldkeynewkeyrvoldmsg fuzzy_matcheskeep_user_commentsmessages remainingrEs r._mergezCatalog.update.._mergesmmoGE!!&)!f-fii-+199+G'*.vyy/G'"vt4#]]GN!(,Xf6J6J-K(L%'**tUm4!'..4-@ E%* (SES_q5H,IJ&GN(D,<,<< E%*7>>:M3v}};M+N%OGNGNNT5M:!(!2 MMV\\ )M (+ &D r0rrN)rr rr6rrDr9r4r@ryrrstripkeysrrr)rEtemplateno_fuzzy_matchingupdate_header_commentr fuzzy_candidatesmsgidr rrmatchkeymatchesrnewctxtr r r s` ` @@@r.updatezCatalog.updatesj>>MMO $ & 8E?3I3I e$huo&=&==    ! '! 'F  /GzzmmGJJ@(?7C-,%c51'*1vH'*H"3HNN4D4J4J4L4D4I4I4KQ#P"%,QZF&6v&>G&2)/"7FC8$'.D$- /0 8E E$>'0'7 e$ 8 !#+"9"9D &33Y s7FcL|}t|ttfr|d}|||f}|S)zThe key for a message is just the singular ID even for pluralizable messages, but is a ``(msgid, msgctxt)`` tuple for context-specific messages. r)r@r7ryrs r.rzCatalog._key_forCs4  cD%= )Q%C  .C r0cbt|tsJ|jj|jjzD];}|j |}|j |}|||j |r;yt |jt |jk(S)z\Checks if catalogs are identical, taking into account messages and headers. F)r@rrrrrgdictr)rErRr message_1 message_2s r.rgzCatalog.is_identicalOs%)))>>&&(5??+?+?+AA C I #I!$ --i8 D%%&$u/A/A*BBBr0)rstrict)NrrrrrNNri)FFT)$rKrrrDEFAULT_HEADERrFrrrrrrrrrrrrrrrrrrrrMrrrr<rtrrrrrgrr0r.rrs6."4td$(#TT 8!tk*'k; /F !78 &13FM NB@G@-/@1G1 Lf!! !!$ P P3# &H 0*dJLCGB &>$H4T Cr0r)'rrcgir collectionsrrrrdifflibremailrr babelr r babel.corer r babel.datesr babel.messages.pluralsr babel.utilrrrr__all__compileVERBOSEr|r/r Exceptionrrrrr0r.r-s #,%%(1'-CC 4 ZZ