+ *:gceRt^RIHt^RIt^RIt^RIHt^RIHtH t ^RI H t ^RI H t Ht^RIHtHt]'d^RIHtHt^R IHtR R ltR R ltRRlt!RR]4t!RR4t!RR4tR.RRllt]P<!R4tRRlt R/RRllt!RRlt"R0R!R"llt#R#RR$R R%RR&RR'RR(RR)^L/R*R+llt$R,R-lt%R#)1z babel.messages.pofile ~~~~~~~~~~~~~~~~~~~~~ Reading and writing of files in the ``gettext`` PO (portable object) format. :copyright: (c) 2013-2025 by the Babel Team. :license: BSD, see LICENSE for more details. ) annotationsN)Iterable) TYPE_CHECKINGLiteral)Locale)CatalogMessage) TextWrapper_cmp)IOAnyStr) SupportsWritec V^8dQhRRRR/#stringstrreturn)formats"7/usr/lib/python3/dist-packages/babel/messages/pofile.py __annotate__rsJJSJSJcXRp\P!R4PW^R4#)zReverse `escape` the given string. >>> print(unescape('"Say:\\n \\"hello, world!\\"\\n"')) Say: "hello, world!" :param string: the string to unescape c^VP^4pVR8XdR#VR8XdR#VR8XdR#V#)n t r )group)matchms& rreplace_escapes!unescape..replace_escapes&s2 KKN 8 #X #Xrz \\([\\trn"]))recompilesub)rr%s& runescaper+s)  ::o & * *?1RL IIrc V^8dQhRRRR/#rr)rs"rrr3s    rcRV9dRVP4pVPR4'd VR,p\\V4pRP V4#\V4#)aReverse the normalization done by the `normalize` function. >>> print(denormalize(r'''"" ... "Say:\n" ... " \"hello, world!\"\n"''')) Say: "hello, world!" >>> print(denormalize(r'''"" ... "Say:\n" ... " \"Lorem ipsum dolor sit " ... "amet, consectetur adipisicing" ... " elit, \"\n"''')) Say: "Lorem ipsum dolor sit amet, consectetur adipisicing elit, " :param string: the string to denormalize r""rNN) splitlines startswithmapr+join)r escaped_linesliness& r denormalizer73sY* v~))+   T " ")"-MHm,wwu~rc V^8dQhRRRR/#)rlinerrz list[str]r)rs"rrrRs))S)Y)rcRV9d&RV9dVP4P4#.pRpRpVFpVR8XdV'd \R4hRpK!VR8XdV'g \R4hRpK?VR8Xd2V'd W$, pKXV'dVPV4RpKuKwW$, pK V'd%V'd \R4hVPV4V#) zExtract locations from location comments. Locations are extracted while properly handling First Strong Isolate (U+2068) and Pop Directional Isolate (U+2069), used by gettext to enclose filenames with spaces and tabs in their names. ⁨⁩r0Fzglocation comment contains more First Strong Isolate characters, than Pop Directional Isolate charactersTzglocation comment contains more Pop Directional Isolate characters, than First Strong Isolate characters )lstripsplit ValueErrorappend)r9 locationslocation in_filenamecs& r_extract_locationsrFRst 4{{}""$$IHK  = "WXXK  (] "TUUK  #X   * MH),  "WXX   X & rc2a]tRt^~tRtRV3RlltRtV;t#) PoFileErrorzDException thrown by PoParser when an invalid po file is encountered.c ,V^8dQhRRRRRRRRRR /#) rmessagercatalogrr9linenointrNoner)rs"rrPoFileError.__annotate__s0gS#RVrc T<\SV`V RV 24W nW0nW@nR#)z on N)super__init__rKr9rL)selfrJrKr9rL __class__s&&&&&rrRPoFileError.__init__s* G9D12   r)rKr9rL)__name__ __module__ __qualname____firstlineno____doc__rR__static_attributes__ __classcell__)rTs@rrHrH~sNrrHc]tRt^tRRltRRltRRltRRltR R ltR R lt R Rlt RRlt RRlt RRlt RRltRRltRtR#)_NormalizedStringc V^8dQhRRRR/#)rargsrrrNr)rs"rr_NormalizedString.__annotate__scdrc H.VnVFpVPV4K R#N)_strsrA)rSr`args&* rrR_NormalizedString.__init__s " C KK rc V^8dQhRRRR/#)rsrrrNr)rs"rrras%%%%rc XVPPVP44R#rc)rdrAstrip)rSrhs&&rrA_NormalizedString.appends !'')$rcV^8dQhRR/#rrrr)rs"rrras22S2rc TRP\\VP44#r0)r4r3r+rdrSs&rr7_NormalizedString.denormalizeswws8TZZ011rcV^8dQhRR/#)rrboolr)rs"rrras  $ rc ,\VP4#rc)rsrdrps&r__bool___NormalizedString.__bool__sDJJrcV^8dQhRR/#rmr)rs"rrras++#+rc T\PPVP4#rc)oslinesepr4rdrps&r__repr___NormalizedString.__repr__szztzz**rc V^8dQhRRRR/#)rotherobjectrrMr)rs"rrras++V++rc RV'g^#\\V4\V44#)r)r rrSr~s&&r__cmp___NormalizedString.__cmp__sCIs5z**rc V^8dQhRRRR/#rr~rrrsr)rs"rrra''F't'rc *VPV4^8#rrs&&r__gt___NormalizedString.__gt__||E"Q&&rc V^8dQhRRRR/#rr)rs"rrrarrc *VPV4^8#rrrs&&r__lt___NormalizedString.__lt__rrc V^8dQhRRRR/#rr)rs"rrra((F(t(rc *VPV4^8#rrrs&&r__ge___NormalizedString.__ge__||E"a''rc V^8dQhRRRR/#rr)rs"rrrarrc *VPV4^8*#rrrs&&r__le___NormalizedString.__le__rrc V^8dQhRRRR/#rr)rs"rrrarrc *VPV4^8H#rrrs&&r__eq___NormalizedString.__eq__rrc V^8dQhRRRR/#rr)rs"rrrarrc *VPV4^8g#rrrs&&r__ne___NormalizedString.__ne__rr)rdN)rVrWrXrYrRrAr7rur{rrrrrrrr[rrrr^r^sC %2 ++ ''(((((rr^c]tRt^tRt.ROtRRRlltRRltRRltRR lt RR R llt RR R llt RRlt RRlt RRltRRltRtR#) PoFileParserzSupport class to read messages from a ``gettext`` PO (portable object) file and add them to a `Catalog` See `read_po` for simple cases. c(V^8dQhRRRRRRRR/#)rrKrignore_obsoleters abort_invalidrrNr)rs"rrPoFileParser.__annotate__s*$$$$$W[$hl$rc fWnW n^Vn^VnW0nVP 4R#)rN)rKrcounteroffsetr_reset_message_state)rSrKrrs&&&&rrRPoFileParser.__init__s- .  * !!#rcV^8dQhRR/#rrrNr)rs"rrrs   d  rc .Vn.Vn.Vn.Vn.Vn.VnRVnRVnRVnRVn RVn R#)NF) messages translationsrBflags user_comments auto_commentscontextobsoletein_msgid in_msgstr in_msgctxtrps&rr!PoFileParser._reset_message_statesR     rcV^8dQhRR/#rr)rs"rrrs$$d$rc  (VPP4\VP4^8dB\;QJd.RVP4FNK 5M!RVP44pM!VP^,P 4p\ V\\34'd\VPP4Uu.uFpRNK ppVPFPwrEW@PP8d VPRVPR4K>VP 4W4&KR \ V4pM(VP^,^,P 4pVP'dVPP 4MRp\W\VP4\!VP"4VP$VP&VP^,VR7pVP('dEVP*'g2WpPP(VPP-W4&MWpPV&V;P.^, unVP14R#uupi)zw Add a message to the catalog based on the current parser state and clear the state ready to process the next message. c3@"TFqP4xK R#5irc)r7).0r$s& r ,PoFileParser._add_message..sA=a--//=sr0z5msg has more translations than num_plurals of catalogN)rLr)rsortlenrtupler7 isinstancelistrangerK num_plurals_invalid_pofilerrrrBsetrrrrr_key_forrr)rSmsgid_ridx translationmsgctxtrJs& r _add_messagePoFileParser._add_messages  t}}  !EA4==AEEA4==AAEMM!$002E edE] + +"' (@(@"AB"AQb"AFB$($5$5 ,,222((T[[:qr)557 %6 6]F&&q)!,88:F04 $,,**,$%dnn)=s4::,,d.@.@WX")+ ==='''OV %%dll&;&;E&KL")LL    !!#'Cs JcV^8dQhRR/#rr)rs"rrrs   rc >VP'dVP'ggVPRVPRVP^,P 4 R24VPP ^\ R4.4VP4R#R#)r0zmissing msgstr for msgid ''N)rrrrr7rAr^rrps&r_finish_current_message$PoFileParser._finish_current_messages ===$$$$$R8RSWS`S`abScSoSoSqRrrs6tu!!((!->r-B)CD     rcV^8dQhRR/#rr)rs"rrrs??T?rc ~VPR4'dVPW!4R#VPWV4R#)"N)r2!_process_string_continuation_line_process_keyword_line)rSrLr9rs&&&&r_process_message_line"PoFileParser._process_message_lines/ ??3    2 24 @  & &vX >rcV^8dQhRR/#rr)rs"rrrs'2'2T'2rc jVPFDpVPV4'd*V\V4,R 9dV\V4RpMKDKF VP W!R4R#VR 9dVP 4W0nVR8XdWnVR9d5RVnRVn VPP\V44R#VR 8XdRVn RVn VPR4'dMVR ,PR ^4wrgVPP\!V4\V4.4R#VPP^\V4.4R#VR8XdRVn\V4VnR#R# \dTP Y!R4EKi;i)r=[Nz$Keyword must be followed by a stringz0Start of line didn't match any expected keyword.rrFTmsgstrr/])r=r)rr)r msgid_plural) _keywordsr2r IndexErrorrrrrrrrrAr^rr?rrMr)rSrLr9rkeywordrermsgs&&&& rr"PoFileParser._process_keyword_lines~~G [??7++S\0Bj0Ps7|}-C1Q+&  /a b  * *  ( ( *  g  K / /#DO DM MM !23!7 8  !DM!DN~~c""r7==a0!!((#c(4Ec4J)KL!!((!->s-C)DE  !"DO,S1DL"= [$$T3YZZ [sr?rrjrr)rSr9rCposrLflagcomments&& r_process_commentPoFileParser._process_comment9s^ $$& 8  s # #.tBx8nnS)!8!!$XAgh%7!8NN))8DS>6*BCNN))8T*:;9"X  % %R)//4 !!$**,/5 "X  % %2hnn&G""))'2    % %d2hnn&6 7&! !sF:: G  G c V^8dQhRRRR/#)rfileobjIO[AnyStr] | Iterable[AnyStr]rrNr)rs"rrrTs  : t rc  \V4Fwr#VP4p\V\4'g&VP VP P 4pV'gKZVPR4'd]VR,PR4'd+VPW#R,P4RR7KVPV4KVPW#4K VP4VP'gVP'g%VP 'gVP"'d]VP$P'\)R44VP*P'^\)R4.4VP-4R#R#R# \d(pTPY2\T44Rp?EKRp?ii;i) z Reads from the file-like object `fileobj` and adds any po file units found in it to the `Catalog` supplied to the constructor. #r/~rT)rNr.) enumeraterjrrdecoderKcharsetr2rr>rr@rrrrrrrrAr^rr)rSrrLr9excs&& rparsePoFileParser.parseTs` &g.LF:: > j# )&1*Rx@Ar)rrrKrrrrrrrrBrrrrrN)rrrr)FF)F)rVrWrXrYrZrrRrrrrrrrrrr[rrrrrsJ I$  $@ ? '2R 86 @BBrrFc4V^8dQhRRRRRRRRR RR RR R /#) rrrlocalezLocale | str | Nonedomainz str | Nonerrsrrrrr)rs"rrr|sN99 *9 9 9 9  9  9 9rc\\WVR7p\WcVR7pVPV4V#)aRead messages from a ``gettext`` PO (portable object) file from the given file-like object (or an iterable of lines) and return a `Catalog`. >>> from datetime import datetime >>> from io import StringIO >>> buf = StringIO(''' ... #: main.py:1 ... #, fuzzy, python-format ... msgid "foo %(name)s" ... msgstr "quux %(name)s" ... ... # A user comment ... #. An auto comment ... #: main.py:3 ... msgid "bar" ... msgid_plural "baz" ... msgstr[0] "bar" ... msgstr[1] "baaz" ... ''') >>> catalog = read_po(buf) >>> catalog.revision_date = datetime(2007, 4, 1) >>> for message in catalog: ... if message.id: ... print((message.id, message.string)) ... print(' ', (message.locations, sorted(list(message.flags)))) ... print(' ', (message.user_comments, message.auto_comments)) (u'foo %(name)s', u'quux %(name)s') ([(u'main.py', 1)], [u'fuzzy', u'python-format']) ([], []) ((u'bar', u'baz'), (u'bar', u'baaz')) ([(u'main.py', 3)], []) ([u'A user comment'], [u'An auto comment']) .. versionadded:: 1.0 Added support for explicit charset argument. :param fileobj: the file-like object (or iterable of lines) to read the PO file from :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 ignore_obsolete: whether to ignore obsolete messages in the input :param charset: the character set of the catalog. :param abort_invalid: abort read if po file is invalid )r r r)r)rrr)rr r rrrrKparsers&&&&&& rread_por|s.lVGDG '- PF LL NrzL(\s+|[^\s\w]*\w+[a-zA-Z]-(?=\w+[a-zA-Z])|(?<=[\w\!\"\'\&\.\,\?])-{2,}(?=\w))c V^8dQhRRRR/#rr)rs"rrrs003030rcRVPRR4PRR4PRR4PRR 4PR R 4,#) zEscape the given string so that it can be included in double-quoted strings in ``PO`` files. >>> escape('''Say: ... "hello, world!" ... ''') '"Say:\\n \\"hello, world!\\"\\n"' :param string: the string to escape z"%s"\z\\rz\tr!z\rrz\nrz\")replace)rs&rescapersN FNN40"74/"74/"74/"74/  00rc(V^8dQhRRRRRRRR/#)rrrprefixwidthrMrr)rs"rrrs.:K:Kc:K3:KC:K:Krc V'EdGV^8Ed?\V4p.pVPR4EFp\\V44V,V8d\P V4pVP 4V'd.p^pV'd\\VR,44^, V,p W,V8d*VP VP44W, pKgV'g VP VP44VP RPV44KEK VP V4EK MVPR4p\V4^8:d \V4#V'd(VR,'gVRVR;;,R, uu&RRPVUu.uFqQ\V4,NK up4,#uupi)a]Convert a string into a format that is appropriate for .po files. >>> print(normalize('''Say: ... "hello, world!" ... ''', width=None)) "" "Say:\n" " \"hello, world!\"\n" >>> print(normalize('''Say: ... "Lorem ipsum dolor sit amet, consectetur adipisicing elit, " ... ''', width=32)) "" "Say:\n" " \"Lorem ipsum dolor sit " "amet, consectetur adipisicing" " elit, \"\n" :param string: the string to normalize :param prefix: a string that should be prepended to every line :param width: the maximum line width; use `None`, 0, or a negative number to completely disable line wrapping Tr0rz"" r') rr1rWORD_SEPr?reverserApopr4) rrr prefixlenr6r9chunksbufsizelengths &&& r normalizer!sj0 uK %%d+D6$< 9,u4!- CD !$VF2J%7!81!>> catalog = Catalog() >>> catalog.add(u'foo %(name)s', locations=[('main.py', 1)], ... flags=('fuzzy',)) >>> catalog.add((u'bar', u'baz'), locations=[('main.py', 3)]) >>> from io import BytesIO >>> buf = BytesIO() >>> write_po(buf, catalog, omit_header=True) >>> print(buf.getvalue().decode("utf8")) #: main.py:1 #, fuzzy, python-format msgid "foo %(name)s" msgstr "" #: main.py:3 msgid "bar" msgid_plural "baz" msgstr[0] "" msgstr[1] "" :param fileobj: the file-like object to write to :param catalog: the `Catalog` instance :param width: the maximum line width for the generated output; use `None`, 0, or a negative number to completely disable line wrapping :param no_location: do not emit a location comment for every message :param omit_header: do not include the ``msgid ""`` entry at the top of the output :param sort_output: whether to sort the messages in the output by msgid :param sort_by_file: whether to sort the messages in the output by their locations :param ignore_obsolete: whether to ignore obsolete messages and not include them in the output; by default they are included as comments :param include_previous: include the old msgid as a comment when updating the catalog :param include_lineno: include line number in the location comment NrJrC)rr-r,r(r)sort_byrbackslashreplace) generate_porrencoderwrite) rrKrr(r)r*r+rr,r-r/r9s &&&&&&&&&& rwrite_por4sqpG '%)  dC ;;w0BCD d rrr-r,r(r)r/rc<V^8dQhRRRRRRRRRRRRR R R R R R/ #)rrKrrrsr-r,r(r)r/%Literal['message', 'location'] | NonerrMrz Iterable[str]r)rs"rrrlsojj jj j  j  jj3j jjrc #aaa"S'd S^8dSM^Lp\VRR7o\SRRR7p RV3Rllp RVV3Rllp \SVR7EFcp V P'gnV'dK SPp S'dIS^8dB.pV P 4FpWP V4, pK R P V4p V R 2xV PFpV !V4R jxL K V PFpV !VR R 7R jxL K V'g.p\V PR R7pVFcwppVP\PR4p\V4pV'dV'd V RVR 2pVV9gKRVP!V4Ke V !RP V4RR 7R jxL V P"'d.RRP R.\V P"4O4 R 2xV P$'dV'dV !R\'V P$^,SR7 2RR 7R jxL \)V P$4^8d4\'V P$^,SR7pV !RV 2RR 7R jxL V !V 4R jxL R xEKf V'gh\SP*P-4VR7F<p V PFpV !V4R jxL K V !V RR 7R jxL R xK> R #R #EL<EL \dT PpEL i;iELELLLLTL@5i)z|Yield text strings representing a ``gettext`` PO (portable object) file. See `write_po()` for a more detailed description. F)rbreak_long_wordsz# )rsubsequent_indentr8r0c3r<"SPV4FpRV RVP4 R2xK R#5i)rr=rN)wraprj)rrr9comment_wrappers&& r_format_comment$generate_po.._format_comments6#((1DfXQtzz|nB/ /2s47c 3<"\VP\\34'dVP'd!V R\ VPVSR7 R2xV R\ VP^,VSR7 R2xV R\ VP^,VSR7 R2x\ SP4F0pVPV,pV RVR R\ W1SR7 R2xK2 R #VP'd!V R\ VPVSR7 R2xV R\ VPVSR7 R2xT R \ VP;'gRVSR7 R2xR # \dRpLi;i5i) zmsgctxt )rrrmsgid msgid_plural r0zmsgstr[dz] zmsgstr N) ridrrrr!rrrr)rJrrrrKrs&& r_format_message$generate_po.._format_messagest gjj4- 0 07??6Y^)_(``bccHF9WZZ]6QV#W"XXZ[ [HM)GJJqM&X]*^)__ab bW001 $^^C0F Awb6X]1^0__abb 27??6Y^)_(``bccHF9WZZe#T"UUWX XHGIgnn.B.B6Y^$_#``bc c" F s<8FBFE30FAF"F3 FFFF)r/rNr)rcxV^,\V^,\4;'dV^,;'gR3#)rr')rrM)xs&rgenerate_po..s0!A$ 1Q48M8V8VRSTURV8\8\Z\1]rkey/rrBr=rz, r@)r|rAz#~ ro)r _sort_messagesrCheader_commentr1r;r4rrsortedrB TypeErrorrrysepr&rAr previous_idr!rrvalues)rKrr-r,r(r)r/r comment_widthheader_wrapperr=rDrJcomment_headerr6r9rlocsrBr#rLrCnorm_previous_idr<sf$$$$$$d @rr1r1ls"#uqyEbM! NO uW\]N0dd&"'7;;zzz$33N*557D0066E8!%5!1#$B' ',,G&w/ / /-,,G&ws; ; ;-D  ."7#4#4']_ %. &#++BFFC89(Cn"*1VAJ7H4'KK) %.'sxx~cB B B ===dii bA A    #3&7#6#6q#9GHI  7&&'!+#,W-@-@-C5#Q *];K:L+MVYZZZ"7+++ gMM#,MMA MMM,M-MAMMMMM.M1M M M  MMMMMMc$V^8dQhRRRRRR/#)rrzIterable[Message]r/r6rz list[Message]r)rs"rrrs$.9^cprc\V4pVR8XdVP4V#VR8XdVPRR7V#)z Sort the given message iterable by the given criteria. Always returns a list. :param messages: An iterable of Messages. :param sort_by: Sort by which criteria? Options are `message` and `location`. :return: list[Message] rJrCcVP#rc)rB)r$s&rrH _sort_messages..sAKKrrJ)rr)rr/s&&rrNrNsCH~H)  O J  / 0 Or)NNFNF)r0L)r^FFFFFFT)&rZ __future__rryr(collections.abcrtypingrr babel.corerbabel.messages.catalogrr babel.utilr r r r _typeshedr r+r7rF ExceptionrHr^rrr)rrr!r&r4r1rNrrrrgs # $)3(!'J. >)X))()(XEBEBP9x :: 0$:Kz"JZj"j j # j  jj6:jjZr