+ *:ga0t$Rt^RIHt^RIt^RIt^RIHtHt^RI H t ^RI H t ^RI H t ^RIHt^RIHt^R IHt^R IHt^R IHtHt^R IHt^R IHt^RIHtH t H!t!H"t"]'d,^RI#H$t$]%]&]%R3,,]']%,,t(R])R&.R$Ot*R%Rlt+]PX!R]PZ4t.RRlt/RRlt0!RR4t1!RR]24t3Rt4RR lt5R&R!R"llt6!R#R4t7R#)'z babel.messages.catalog ~~~~~~~~~~~~~~~~~~~~~~ Data structures for message catalogs. :copyright: (c) 2013-2025 by the Babel Team. :license: BSD, see LICENSE for more details. ) annotationsN)IterableIterator)copy)SequenceMatcher)message_from_string)nlargest) Formatter) TYPE_CHECKING) __version__)LocaleUnknownLocaleError)format_datetime) get_plural)LOCALTZFixedOffsetTimezone_cmpdistinct) TypeAlias.r _MessageIDCatalogMessageTranslationErrorcV^8g\RV: 24hRTu;8:dR8:gM\RV: 24h.p\RR7pVPV4VFzpVPV4VP 4V8gK+VP 4V8gKBVP 4V8gKYVPVP 4V34K| \W$4pVUUu.uFwrvVNK upp#uuppi)zA modified version of ``difflib.get_close_matches``. It just passes ``autojunk=False`` to the ``SequenceMatcher``, to work around https://github.com/python/cpython/issues/90825. zn must be > 0: gg?zcutoff must be in [0.0, 1.0]: F)autojunk) ValueErrorrset_seq2set_seq1real_quick_ratio quick_ratioratioappendr)word possibilitiesncutoffresultsxscores&&&& 8/usr/lib/python3/dist-packages/babel/messages/catalog.pyget_close_matchesr+*s q5?1%011 & C 9&DEE F'AJJt  1   6 ) ==?f $ 779  MM1779a. ) a F$ %f(%Af %% %s& C7z \% (?:\(([\w]*)\))? ( [-#0\ +]?(?:\*|[\d]+)? (?:\.(?:\*|[\d]+))? [hlL]? ) ([diouxXeEfFgGcrs%]) c V^8dQhRRRR/#)stringstrreturnbool)formats"r* __annotate__r4PsSTcRV9dR#\4pRpVPV4FpV^,fKRpK V# \dR#i;i){FT)r parser)r.fmtfield_name_seents& r*_has_python_brace_formatr<Ps^ & +C  6"At"&#  sAA AAc V^8dQhRRRR/#)r-valuer/r0zdatetime.datetimer2)r3s"r*r4r4cs#*;r5c\P!RV4p\PPVP R4R4pVP R4pVe}V^,VR,rTVR,VR,rv\ V R24p\ V4p \ V4p V ^<,p W, p W,p \ V 4pVPVR7pV#) z+^(?P.*?)(?P[+-]\d{4})?$datetimez%Y-%m-%d %H:%Mtzoffset:NN:Nr-N:r-NN1tzinfo)rematchr@strptimegroupintrreplace) r>rGdtrA plus_minus_sresthours_offset_s mins_offset_s plus_minus hours_offset mins_offsetnet_mins_offsets & r*_parse_datetime_headerrUcs HHCU KE    # #EKK $;=M NB{{:&H%a[(2,d(,R$r( L>+, >* -( '+&%'7ZZxZ ( Ir5c ]tRt^tRtR$RRlltRRltRRltR R ltR R lt R Rlt RRlt RRlt RRlt RRltRRltR%RRllt]RRl4t]RRl4t]RR l4t]R!R"l4tR#tR#)&rz0Representation of a single message in a catalog.Nc@V^8dQhRRRRRRRRR RR RR RR R RRRR/ #)r-idrr._MessageID | None locationsIterable[tuple[str, int]]flags Iterable[str] auto_comments user_comments previous_idlineno int | Nonecontext str | Noner0Noner2)r3s"r*r4Message.__annotate__sn11 1"1- 1  1 % 1%1 111 1r5c  WnV'gVP'dRpW n\\ V44Vn\ V4VnV'd/VP'dVPPR4MVPPR4V'd/VP'dVPPR4MVPPR4\\ V44Vn \\ V44Vn \V\4'd V.VnM\V4VnWnWnR#)aCreate 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 z python-formatzpython-brace-formatN)rh)rX pluralizabler.listrrZsetr\ python_formatadddiscardpython_brace_formatr^r_ isinstancer/r`rarc) selfrXr.rZr\r^r_r`rarcs &&&&&&&&&&r*__init__Message.__init__s8$+++F hy12Z $$$$ JJNN? + JJ   / $*** JJNN0 1 JJ  4 5!(="9:!(="9: k3 ' ' +}D #K0D   r5cV^8dQhRR/#r-r0r/r2)r3s"r*r4rfsTT#Tr5c ~R\V4P RVP: R\VP4: R2#)< z (flags: z)>)type__name__rXrjr\rqs&r*__repr__Message.__repr__s74:&&'q 9T$**=M.values_to_comparesT#w''C,<,<,<vvay#++"3"333663;;,,", ,r5)r)rqrrs&& r*__cmp__Message.__cmp__s" -%d+->u-EFFr5c V^8dQhRRRR/#r-rrr0r1r2)r3s"r*r4rf''F't'r5c *VPV4^8#rrrqrs&&r*__gt__Message.__gt__||E"Q&&r5c V^8dQhRRRR/#rr2)r3s"r*r4rfrr5c *VPV4^8#rrrs&&r*__lt__Message.__lt__rr5c V^8dQhRRRR/#rr2)r3s"r*r4rf((F(t(r5c *VPV4^8#rrrs&&r*__ge__Message.__ge__||E"a''r5c V^8dQhRRRR/#rr2)r3s"r*r4rfrr5c *VPV4^8*#rrrs&&r*__le__Message.__le__rr5c V^8dQhRRRR/#rr2)r3s"r*r4rfrr5c *VPV4^8H#rrrs&&r*__eq__Message.__eq__rr5c V^8dQhRRRR/#rr2)r3s"r*r4rfrr5c *VPV4^8g#rrrs&&r*__ne__Message.__ne__rr5c V^8dQhRRRR/#)r-rrr0r1r2)r3s"r*r4rfs//'/d/r5c d\V\4'gQhVPVP8H#)zKChecks whether messages are identical, taking into account all properties. )rpr__dict__rs&&r* is_identicalMessage.is_identicals*%))))}}..r5cV^8dQhRR/#)r-r0rr2)r3s"r*r4rfs@@w@r5c \\\VPVPVP VP VPVPVPVPVP3 4!#N) rmaprrXr.rZr\r^r_r`rarcr{s&r*clone Message.clones^D477DKK#'::t/A/A#'#5#5t7G7G#';; #>?@ @r5c V^8dQhRRRR/#)r-catalogzCatalog | Noner0zlist[TranslationError]r2)r3s"r*r4rfs^7Mr5c ^RIHp.pVF pV!W4K V# \dpTPT4Rp?K4Rp?ii;i)a]Run 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. )checkersN)babel.messages.checkersrrr!)rqrrerrorscheckeres&& r*check Message.checksK 5)+G !&  $ ! a   !s A?AcV^8dQhRR/#r-r0r1r2)r3s"r*r4rfs % %t %r5c RVP9#)zWhether the translation is fuzzy. >>> Message('foo').fuzzy False >>> msg = Message('foo', 'foo', flags=['fuzzy']) >>> msg.fuzzy True >>> msg :type: `bool`fuzzyr\r{s&r*r Message.fuzzys$**$$r5cV^8dQhRR/#rr2)r3s"r*r4rfs 2 2d 2r5c B\VP\\34#)zWhether the message is plurizable. >>> Message('foo').pluralizable False >>> Message(('foo', 'bar')).pluralizable True :type: `bool`)rprXrjtupler{s&r*riMessage.pluralizables$''D%=11r5cV^8dQhRR/#rr2)r3s"r*r4rfs ; ;t ;r5c VPp\V\\34'gV.p\;QJdRV4F 'gK R# R#!RV44#)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`c3L"TFp\PV4xK R#5ir) PYTHON_FORMATsearch.0rXs& r* (Message.python_format..s:c=''++cs"$TFrXrprjranyrqidss& r*rlMessage.python_formatsNgg#e}--%Cs:c:ss:s:s:c:::r5cV^8dQhRR/#rr2)r3s"r*r4rfs ? ?T ?r5c VPp\V\\34'gV.p\;QJdRV4F 'gK R# R#!RV44#)zWhether the message contains Python f-string parameters. >>> Message('Hello, {name}!').python_brace_format True >>> Message(('One apple', '{count} apples')).python_brace_format True :type: `bool`c38"TFp\V4xK R#5ir)r<rs& r*r.Message.python_brace_format..+s>#B+B//#sTFrrs& r*roMessage.python_brace_formatsNgg#e}--%Cs>#>ss>s>s>#>>>r5) r^rcr\rXrarZr`r.r_)rhr2r2r2r2r2NNr)rz __module__ __qualname____firstlineno____doc__rrr|rrrrrrrrrrpropertyrrirlro__static_attributes__r2r5r*rrs:1fTG''((((/@ & % % 2 2 ; ; ? ?r5c]tRtRtRtRtR#)ri.z[Exception thrown by translation checkers when invalid message translations are encountered.r2N)rzrrrrrr2r5r*rr.s%r5z# Translations template for PROJECT. # Copyright (C) YEAR ORGANIZATION # This file is distributed under the same license as the PROJECT project. # FIRST AUTHOR , YEAR. #c V^8dQhRRRR/#)r-r>r/r0zdict[str, str]r2)r3s"r*r4r4;s  # . r5cV^RIHpV!4pWR&\VP44#)r)r content-type) email.messagerdict get_params)r>rms& r*parse_separated_headerr;s%% An   r5c(V^8dQhRRRRRRRR/#)r-r'z str | bytesencodingr/rr0r2)r3s"r*r4r4Cs);#TWr5c\V\4'dV#\V\4'dVPW4#\V4#r)rpr/bytesdecode)r'rrs&&&r* _force_textrCs9!S!Uxx)) q6Mr5c ]tRtRtRtRR]RRRRRRRRRR3 RRlltRRltR R ltR R lt ] !]]4t ] !] 4t R Rlt RRlt] !] ]RR7tRRltRRlt] !]]RR7t] RRl4t] RRl4t] RRl4tRRltR R!ltR"R#ltR$R%ltR&R'ltR(R)ltR*R+ltR=R,R-lltR.R/ltR>R0R1lltR>R2R3llt R?R4R5llt!R6R7lt"R>R8R9llt#R:R;lt$RzLANGUAGE utf-8NrDzYEAR-MO-DA HO:MI+ZONE)rr_header_comment _messagesrrrrrrrr@nowrrprErKrrrobsolete _num_plurals _plural_expr)rqrrrrrrrrrrrrrs&&&&&&&&&&&&&&r*rrCatalog.__init__NsEH  -?A++) ++) 0 B BN"4"G"G.MM2M<*DD.D:))'  $--11':M  x'8'8 9 9-BVBVBV)111AM*  3M  x'8'8 9 9-BVBVBV)111AM* ?A   r5c V^8dQhRRRR/#)r-rrr0rer2)r3s"r*r4rskk"5k$kr5c ^VfRVnRVnR#\V\4'd\ V4VnWnR#\V\4'd/\ V4Vn\P !V4VnR#\RV: 24h \ d RTnR#i;i)NzD`locale` must be a Locale, a locale identifier string, or None; got )_locale_identifier_localerpr r/r8r TypeErrorrqrs&&r* _set_localeCatalog._set_locales >&*D #DL  ff % %&)&kD #!L  fc " "&)&kD # $%||F3  ^_e^hijj & $#  $s*BB,+B,cV^8dQhRR/#)r-r0z Locale | Noner2)r3s"r*r4rs]r5c VP#r)rr{s&r* _get_localeCatalog._get_locales ||r5cV^8dQhRR/#)r-r0rdr2)r3s"r*r4rs'' 'r5c VP#r)rr{s&r*_get_locale_identifierCatalog._get_locale_identifiers&&&r5cV^8dQhRR/#rur2)r3s"r*r4rs  S r5c RVPp\PP\4P R4p\ VP R4'dVP P R4pVPRVP4PRVP4PRV4PRVP4pVP'dVPPM VPpV'dVPRV R24pV#)z%YstrftimerrYEARrzTranslations templatez translations)rr@rrrhasattrrrKrrrr english_namelocale_identifier)rqcommentyear locale_names& r*_get_header_commentCatalog._get_header_comments&&  $$W-66t< 4%%z 2 2%%..t4D//)T\\:!')T\\:!'&$/!'.$2G2GH 48;;;t{{//DDZDZ oo&=+m?\]Gr5c V^8dQhRRRR/#)r-r.rdr0rer2)r3s"r*r4rs&&*&&r5c WnR#r)r)rqr.s&&r*_set_header_commentCatalog._set_header_comments%r5a 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` )doccV^8dQhRR/#)r-r0zlist[tuple[str, str]]r2)r3s"r*r4rs#8r5c  L\VP\P\P\\ 34'd\ VPRRR7pM VPpVPpVP'd-RV9d&VPR\VP44pRVP RVP 23RVP3R\ VPRRR73RV3R VP3.pVP'd'VP!R \VP434VP!R V34VP"eVP!R VP$34VRR RVP& 23RRR\( R23., pV#)zyyyy-MM-dd HH:mmZen)rLANGUAGEzProject-Id-VersionrxzReport-Msgid-Bugs-TozPOT-Creation-DatezPO-Revision-DatezLast-TranslatorLanguagez Language-Teamz Plural-Formsz Content-Typeztext/plain; charset=z Generated-ByzBabel  )z MIME-Versionz1.0)zContent-Transfer-Encoding8bit)rprr@timerJfloatrrr"rKr/rrrrrr!r plural_formsrr)rqrrheaderss& r*_get_mime_headersCatalog._get_mime_headerss d((8+<+,>@S\`aM ..M**  ! ! !jM&A)11*c$BXBX>YZM"dll^1T\\N#C D #T%<%< = /$2D2DFYbf"g h  /  4 4 5 *   ! ! ! NNJD,B,B(CD E78 ;; " NNND,=,=> ? # 3DLL>B C 1 vgYb1 2    r5c V^8dQhRRRR/#)r-r7zIterable[tuple[str, str]]r0rer2)r3s"r*r4rs"G"G)B"Gt"Gr5c nVEFwr#\VP4VPR7p\W0PR7pVR8Xd;VPR4pRP VRR4VnVR,VnKVR8Xd W0nKVR8Xd W0nKVR8Xd0VPRR4pTPT;'gR4KVR 8Xd W0n KVR 8Xd5\V4pR V9d VR ,P4VnEKEK VR 8XdI\R V 24p\VPR^44VnVPRR4VnEKoVR8Xd\#V4VnEKVR8XgEKRV9gEK\#V4VnEK R#))rzproject-id-versionrxNzreport-msgid-bugs-tozlast-translatorlanguage-_z language-teamrrz plural-formsz ;npluralsplural(n != 1)zpot-creation-datezpo-revision-dater)rlowerrsplitjoinrrrrrKrrrrJgetr r rUrr)rqr7namer>partsparamss&& r*_set_mime_headersCatalog._set_mime_headerssp"KDtzz|dllCD =E++ C("xxcr 3 $Ry //*/'**',$# c3/   $/(%*"'/6&#))#4#:#:#>> from babel.dates import UTC >>> from datetime import datetime >>> 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` cV^8dQhRR/#r-r0rJr2)r3s"r*r4r[s!!S!r5c VPf7^pVP'd\VP4^,pWnVP#)zThe number of plurals used by the catalog or locale. >>> Catalog(locale='en').num_plurals 2 >>> Catalog(locale='ga').num_plurals 5 :type: `int`)r rr)rqnums& r* num_pluralsCatalog.num_pluralsZsC    $C{{{ -a0 #    r5cV^8dQhRR/#rur2)r3s"r*r4rls!!S!r5c VPf7RpVP'd\VP4^,pWnVP#)aThe 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`rA)r rr)rqexprs& r* plural_exprCatalog.plural_exprksC    $D{{{!$++.q1 $    r5cV^8dQhRR/#rur2)r3s"r*r4rs J Jc Jr5c <RVP RVP R2#)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=;)rPrUr{s&r*r6Catalog.plural_forms~s'4++,Id6F6F5GqIIr5c V^8dQhRRRR/#)r-rXrr0r1r2)r3s"r*r4rs33z3d3r5c >VPV4VP9#)z?Return whether the catalog has a message with the specified ID._key_forrrqrXs&&r* __contains__Catalog.__contains__s}}R DNN22r5cV^8dQhRR/#rMr2)r3s"r*r4rs###r5c ,\VP4#)z]The number of messages in the catalog. This does not include the special ``msgid ""`` entry.)lenrr{s&r*__len__Catalog.__len__s4>>""r5cV^8dQhRR/#)r-r0zIterator[Message]r2)r3s"r*r4rs & &+ &r5c# B".pVPFwr#VPV RV 24K \4pVP'd VR0,p\ RRP V4VR7xVP FpVP V,xK R#5i)zIterates through all the entries in the catalog, in the order they were added, yielding a `Message` object for every entry. :rtype: ``iterator``z: rrhr2rN) mime_headersr!rkrrrEr)rqbufrGr>r\keys& r*__iter__Catalog.__iter__s ,,KD JJ$r%) *- ::: gY Eb$))C.66>>C..% %"sBBcV^8dQhRR/#rur2)r3s"r*r4rsBB#Br5c RpVP'dRVP 2pR\V4P RVP: V R2#)rhrxrw>)rryrzrrs& r*r|Catalog.__repr__sH ;;; &F4:&&'qxqAAr5c V^8dQhRRRR/#)r-rXrr0rer2)r3s"r*r4rsjTr5c (VPV4R#)z)Delete the message with the specified ID.N)deleter_s&&r* __delitem__Catalog.__delitem__s  Br5c V^8dQhRRRR/#)r-rXrr0rr2)r3s"r*r4rsjWr5c $VPV4#)zEReturn the message with the specified ID. :param id: the message ID )rFr_s&&r* __getitem__Catalog.__getitem__s xx|r5c$V^8dQhRRRRRR/#)r-rXrmessagerr0rer2)r3s"r*r4rs!.*.*j.*7.*t.*r5c \V\4'gQR4hVPWP4pVPP V4pV'EdVP 'd5VP 'g#VPVnVPVn\\VPVP,44Vn \\VPVP,44Vn \\VPVP,44Vn V;PVP,unR#VR8Xd}\VP4P!4VnRP%VPUu.uFpRV 2P'4NK up4VnVP*VnR#\V\\,34'dD\VP\\,34'gQR\/VP4 24hW PV&R#uupi)aiAdd 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 objectrhr2z# zExpected sequence but got N)rprr^rcrrFrirXr.rjrrZr^r_r\ritemsrirErstriprrrry)rqrXr|rkcurrentcs&&& r* __setitem__Catalog.__setitem__s,'7++H-HH+mmB0..$$S) 7###G,@,@,@$ZZ !( $Xg.?.?.5.?.?/@&A!BG $('2G2G292G2G3H*I%JG !$('2G2G292G2G3H*I%JG ! MMW]] *M 2X 3GNN C I I KD "&))H]H],^H]1r!X__->H],^"_D  DJ"tUm,,!'..4-@@H0gnn1E0FGH@")NN3  -_s,Ic@V^8dQhRRRRRRRRR RR RR RR R RRRR/ #)r-rXrr.rYrZr[r\r]r^r_r`rarbrcrdr0rr2)r3s"r*r4rsn)) )")- )  ) % )%) ))) )r5c  B\W\V4WEWgVV R7 p WV&V #)aAdd 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 )rarc)rrj) rqrXr.rZr\r^r_r`rarcr|s &&&&&&&&&& r*rm Catalog.adds/J"d9ou'V")+Rr5cV^8dQhRR/#)r-r0z0Iterable[tuple[Message, list[TranslationError]]]r2)r3s"r*r4rs & &G &r5c# "VPP4F$pVPVR7pV'gKW3xK& R#5i)a4Run 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: ``generator`` of ``(message, errors)`` )rN)rvaluesr)rqr|rs& r*r Catalog.checks;~~,,.G]]4]0Fvo%/s 5A Ac$V^8dQhRRRRRR/#)r-rXrrcrdr0zMessage | Noner2)r3s"r*r4rs!>>j>:>>r5c VVPPVPW44#)zReturn the message with the specified ID and context. :param id: the message ID :param context: the message context, or ``None`` for no context )rrFr^)rqrXrcs&&&r*rF Catalog.gets" ~~!!$--"<==r5c$V^8dQhRRRRRR/#)r-rXrrcrdr0rer2)r3s"r*r4r%s!$$$j$D$r5c fVPW4pW0P9dVPVR#R#)zDelete the message with the specified ID and context. :param id: the message ID :param context: the message context, or ``None`` for no context Nr]rqrXrcrks&&& r*rtCatalog.delete%s- mmB( .. s# !r5c 0V^8dQhRRRRRRRRRRRR /#) r-templaterno_fuzzy_matchingr1update_header_commentkeep_user_commentsupdate_creation_dater0rer2)r3s"r*r4r/sNU8U8U8 U8 $ U8 ! U8 # U8 U8r5c aaaaaSPoSP4o/Sn/pV'ghSFapV'gK SV,P'gK(SPV4pSV,Pp W3VSP V4&Kc \ 4oRVVVVV3Rllp VFp V P'gKSPV PV P4pVS9d V !WV4KOV'gX\SP V4VP4^4p V 'd&V ^,p Wm,wrVeW3pV !WV4KV SV P&K SF*pV'g VS9gKSV,SPV&K, V'dVPSn V'dVPSn R#R#)aBUpdate 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 :param update_header_comment: whether to copy the header comment from the template :param keep_user_comments: whether to keep user comments from the old catalog :param update_creation_date: whether to copy the creation date from the template c(V^8dQhRRRRRRRR/#)r-r|roldkeytuple[str, str] | strnewkeyr0rer2)r3s"r*r4$Catalog.update..__annotate__|s+# '# 'G# '-B# 'La# 'fj# 'r5c<VP4pRpW8wdyRpSPV4SPV4pVfQh\VP\ 4'dVP.VnM3\VP4VnMSPVR4pVfQhVPVn S'd$\\VP44Vn \VP\\34'd\VP\\34'gHRp\VP.R.\VP4^, ,,4Vn M\VP4S P8wd3Rp\VPR\VP44Vn M@\VP\\34'dRpVP^,Vn V;PVP,unV'dV;PR0,unVS VP&R#)FTNrhr)rrmrFrprXr/r`rjpopr.rr_rrdrPr\) r|rrroldmsg fuzzy_matchesrmessages remainingrqs &&& r*_mergeCatalog.update.._merge|smmoGE!!&)!f-)))fii--+199+G'*.vyy/G'"vt4)))#]]GN!(,Xf6J6J-K(L%'**tUm44!'..4-@@ E%* (RDC Oa4G,HI&GN(D,<,<< E%*7>>:M3v}};M+N%OGNGNNT5M::!(!2 MMV\\ )M '* &D r5N) rrr.r^rc_to_fuzzy_match_keyrkrXr+keysrrr)rqrrrrrfuzzy_candidatesmsgidrkctxtrr|matches modified_keyrnewctxtrrrsf&&&f& @@@r*updateCatalog.update/s~>>MMO  !5Xe_333--.C#E?22DGJk$T%=%=c%BC "  # '# 'J GzzzmmGJJ@(?7-,"3 44S9,113# #+21:L.>.LOF&2)/"7C8$'.D$+ .E E$>'0'7 e$ !#+"9"9D  !)!7!7D  r5c V^8dQhRRRR/#)r-rkrr0r/r2)r3s"r*r4rs(('<((r5c \V\4'd V^,pMTpVP4P4#)z?Converts a message key to a string suitable for fuzzy matching.)rprrCstrip)rqrkmatchkeys&& r*rCatalog._to_fuzzy_match_keys3 c5 ! !1vHH~~%%''r5c$V^8dQhRRRRRR/#)r-rXrrcrdr0rr2)r3s"r*r4rs"  :  F[ r5c bTp\V\\34'd V^,pVeW23pV#)zThe key for a message is just the singular ID even for pluralizable messages, but is a ``(msgid, msgctxt)`` tuple for context-specific messages. )rprjrrs&&& r*r^Catalog._key_fors5  cD%= ) )Q%C  .C r5c V^8dQhRRRR/#)r-rrr0r1r2)r3s"r*r4rsCC'CdCr5c \V\4'gQhVPP4VPP4,FGpVP V4pVP V4pVeVeVP V4'dKFR# \ VP4\ VP48H#)zLChecks if catalogs are identical, taking into account messages and headers. F)rprrrrFrrri)rqrrk message_1 message_2s&& r*rCatalog.is_identicals%))))>>&&(5??+?+?+AAAC I #I!$ --i88BD%%&$u/A/A*BBBr5)rrrrr r rrrrrrrrrrirrrrr)Nr2r2r2r2r2NNr)FFTT)&rzrrrrDEFAULT_HEADERrrrrrrrr"r&r*rr8rJrirPrUr6r`rerlr|ruryrrmrrFrtrrr^rrr2r5r*rrKs<.'+!%3""'+)-8$U8n( CCr5)rrrrr)g333333?)rstrict)8__conditional_annotations__r __future__rr@rFcollections.abcrrrdifflibremailrheapqrr.r typingr babelr r babel.corer r babel.datesrbabel.messages.pluralsr babel.utilrrrrtyping_extensionsrr/rrjr__annotations____all__r+compileVERBOSErr<rUr Exceptionrrrrr)rs@r*rs# .#% (1'-CC+%S/1DI=J = &4 ZZ  &