̆hceSrSSKJr SSKrSSKrSSKJr SSKJrJ r SSK J r SSK J r Jr SSKJrJr \(aSS KJrJr SS KJr S S jrS S jrS!S jr"SS\5r"SS5r"SS5rS"S#Sjjr\R<"S5rS Sjr S$S%Sjjr!S&Sjr"S'S(Sjjr#SSSSSSSS.S)Sjjr$S*Sjr%g)+z 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) SupportsWritecXSn[R"S5RXSS5$)zReverse `escape` the given string. >>> print(unescape('"Say:\\n \\"hello, world!\\"\\n"')) Say: "hello, world!" :param string: the string to unescape cRURS5nUS:XagUS:XagUS:XagU$)Nn t r )group)matchms M/opt/services/DDDS/venv/lib/python3.13/site-packages/babel/messages/pofile.pyreplace_escapes!unescape..replace_escapes&s2 KKN 8 #X #Xz \\([\\trn"])r)recompilesub)stringrs runescaper$s)  ::o & * *?1RL IIrcSU;aLUR5nURS5(aUSSn[[U5nSR U5$[U5$)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""rN) splitlines startswithmapr$join)r# escaped_linesliness r denormalizer.3s[* v~))+   T " ")!"-MHm,wwu~rcSU;a$SU;aUR5R5$/nSnSnUHpnUS:XaU(a [S5eSnMUS:XaU(d [S5eSnM;US:Xa+U(aX$- nMNU(aURU5 SnMjMlX$- nMr U(a#U(a [S5eURU5 U$) 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. ⁨⁩r'Fzglocation 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)line locationslocation in_filenamecs r_extract_locationsr<Rst 4{{}""$$IHK  = "WXXK  (] "TUUK  #X   * MH),  "WXX   X & rc0^\rSrSrSrSU4SjjrSrU=r$) PoFileError~zDException thrown by PoParser when an invalid po file is encountered.cR>[TU]USU35 X lX0lX@lg)Nz on )super__init__catalogr7lineno)selfmessagerCr7rD __class__s rrBPoFileError.__init__s* G9D12   r)rCr7rD) rFstrrCrr7rIrDintreturnNone)__name__ __module__ __qualname____firstlineno____doc__rB__static_attributes__ __classcell__)rGs@rr>r>~sNrr>c\rSrSrSSjrSSjrSSjrSSjrSSjrSSjr SSjr SS jr SS jr SS jr SS jrSS jrSrg)_NormalizedStringcF/UlUHnURU5 M gN)_strsr6)rEargsargs rrB_NormalizedString.__init__s " C KK rcVURRUR55 grX)rYr6strip)rEss rr6_NormalizedString.appends !'')$rcTSR[[UR55$)Nr')r+r*r$rYrEs rr._NormalizedString.denormalizeswws8TZZ011rc,[UR5$rX)boolrYrbs r__bool___NormalizedString.__bool__sDJJrcT[RRUR5$rX)oslinesepr+rYrbs r__repr___NormalizedString.__repr__szztzz**rcNU(dg[[U5[U55$)Nr)r rIrEothers r__cmp___NormalizedString.__cmp__sCIs5z**rc*URU5S:$Nrrprns r__gt___NormalizedString.__gt__||E"Q&&rc*URU5S:$rsrtrns r__lt___NormalizedString.__lt__rwrc*URU5S:$rsrtrns r__ge___NormalizedString.__ge__||E"a''rc*URU5S:*$rsrtrns r__le___NormalizedString.__le__r~rc*URU5S:H$rsrtrns r__eq___NormalizedString.__eq__r~rc*URU5S:g$rsrtrns r__ne___NormalizedString.__ne__r~r)rYN)rZrIrKrL)r_rIrKrL)rKrI)rKre)roobjectrKrJ)rorrKre)rMrNrOrPrBr6r.rfrkrpruryr|rrrrRrrrUrUs> %2 ++ ''((((rrUc\rSrSrSr/SQrSSSjjrSSjrSSjrSSjr SSSjjr SSS jjr SS jr SS jr SS jrSS jrSrg) PoFileParserzSupport class to read messages from a ``gettext`` PO (portable object) file and add them to a `Catalog` See `read_po` for simple cases. )msgidmsgstrmsgctxt msgid_pluralcdXlX lSUlSUlX0lUR 5 grs)rCignore_obsoletecounteroffset abort_invalid_reset_message_state)rErCrrs rrBPoFileParser.__init__s- .  * !!#rc/Ul/Ul/Ul/Ul/Ul/UlSUlSUlSUlSUl SUl g)NF) messages translationsr8flags user_comments auto_commentscontextobsoletein_msgid in_msgstr in_msgctxtrbs rr!PoFileParser._reset_message_statesR     rc URR5 [UR5S:a[ SUR55nOURSR 5n[ U[[45(a[URR5Vs/sHnSPM nnURHOupEX@RR:aURSURS5 M=UR 5X4'MQ [ U5nO URSSR 5nUR(aURR 5OSn[X[UR5[!UR"5UR$UR&URS-US9nUR((aCUR*(d1XpRR(URR-X5'OXpRU'U=R.S- slUR15 gs snf)zw Add a message to the catalog based on the current parser state and clear the state ready to process the next message. rc3@# UHoR5v M g7frX)r.).0rs r ,PoFileParser._add_message..sA=a--//=srr'z5msg has more translations than num_plurals of catalogN)rDr)rsortlenrtupler. isinstancelistrangerC num_plurals_invalid_pofilerrr r8setrrrrr_key_forrr)rEr_r#idx translationrrFs r _add_messagePoFileParser._add_messages  t}}  !A4==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* Ic.UR(aUR(dbURSURSURSR 5S35 URR S[ S5/5 UR5 gg)Nr'zmissing msgstr for msgid 'r')rrrrr.r6rUrrbs r_finish_current_message$PoFileParser._finish_current_messagesz ==$$$$R8RSWS`S`abScSoSoSqRrrs6tu!!((!->r-B)CD     rcxURS5(aURX!5 gURXU5 g)N")r)!_process_string_continuation_line_process_keyword_line)rErDr7rs r_process_message_line"PoFileParser._process_message_lines/ ??3    2 24 @  & &vX >rc<URH>nURU5(a$U[U5S;aU[U5Sn OM>M@ UR X!S5 gUS;aUR 5 X0lUS:XaXlUS;a3SUlSUl URR[U55 gUS :XaSUl SUl URS 5(aGUS SRS S 5upgURR[!U5[U5/5 gURRS [U5/5 gUS:XaSUl[U5Ulgg![a UR X!S5 GMf=f)N)r2[z$Keyword must be followed by a stringz0Start of line didn't match any expected keyword.)rrr)rrFTrrr]rr) _keywordsr)r IndexErrorrrrrrrrr6rUrr4rrJr)rErDr7rkeywordr[rmsgs rr"PoFileParser._process_keyword_lines~~G [??7++S\0Bj0Ps7|}-C1Q+&  /a b  * *  ( ( *  g  K / /#DO DM MM !23!7 8  !DM!DN~~c""qr7==a0!!((#c(4Ec4J)KL!!((!->s-C)DE  !"DO,S1DL"= [$$T3YZZ [s6E::FFcUR(aURSnOUUR(aURSSnO1UR(a UR nOUR XS5 gURU5 g)Nrrz6*BCNN))8T*:;9!"X  % %QR)//4 !!$**,/5 !"X  % %12hnn&G""))'2    % %d12hnn&6 7&! !sF FFc [U5Hup#UR5n[U[5(d%UR UR R 5nU(dMXURS5(aPUSSRS5(a#URX#SSR5SS9 MURU5 MURX#5 M UR5 UR(dUR(d"UR (dUR"(a[UR$R'[)S55 UR*R'S [)S5/5 UR-5 ggg![a'nURX2[U55 SnAGMSnAff=f) z Reads from the file-like object `fileobj` and adds any po file units found in it to the `Catalog` supplied to the constructor. #rN~rT)rr&r) enumerater^rrIdecoderCcharsetr)rr3rr5rrrrrrrr6rUrr)rEfileobjrDr7excs rparsePoFileParser.parseTsZ &g.LF::rCprint)rEr7rDrs rrPoFileParser._invalid_pofiletsS$$$$$   c<<> > j# )&1*Rx@Ar)rrrCrrrrrrrr8rrrrrN)FF)rCrrrerrerKrL)rKrL)F)rIO[AnyStr] | Iterable[AnyStr]rKrL)rMrNrOrPrQrrBrrrrrrrrrrRrrrrrsD I$  $@ ? '2R 86 @BrrFcP[XUS9n[XcUS9nURU5 U$)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 )localedomainr)r)rrr)rrrrrrrCparsers rread_por|s.lVGDG '- PF LL NrzL(\s+|[^\s\w]*\w+[a-zA-Z]-(?=\w+[a-zA-Z])|(?<=[\w\!\"\'\&\.\,\?])-{2,}(?=\w))cSURSS5RSS5RSS5RSS 5RS S 5-$) 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\trz\rrz\nrz\")replace)r#s rescapersN FNN40"74/"74/"74/"74/  00rLc U(Ga8US:Ga1[U5n/nURS5GH n[[U55U-U:a[R U5nUR 5 U(a/nSnU(ay[[US55S- U-n X-U:a$UR UR55 X- nO'U(dUR UR55 O U(aMyUR SRU55 U(aMMMUR U5 GM OURS5n[U5S::a [U5$U(aUS(dUS US==S- ss'SSRUVs/sHoQ[U5-PM sn5-$s snf) 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 rTrrr'rrz"" ) rr(rWORD_SEPr4reverser6popr+) r#prefixwidth prefixlenr-r7chunksbufsizelengths r normalizersn0 K %%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 NrFr9rinclude_linenoinclude_previous no_location omit_headersort_byrbackslashreplace) generate_porrIencoderwrite) rrCrrr sort_output sort_by_filerrrrr7s rwrite_por sqpG '%)  dC ;;w0BCD d rrc #8^^^# T(aTS:aTOSn[USS9m[TSSS9n SU4Sjjn SUU4S jjn [TUS 9GH6n U R(dfU(aMTRn T(aCTS:a=/nU R 5HnXR U5- nM S R U5n U S 3v U RHnU "U5S hvN M U RHnU "US S9S hvN M U(d/n[U RSS9nUH`unnUR[RS5n[U5nU(aU(aUSUS3nUU;dMOUR!U5 Mb U "SR U5SS9S hvN U R"(a-SSR S/[U R"5Q5S 3v U R$(apU(aiU "S['U R$STS93SS9S hvN [)U R$5S:a)['U R$STS9nU "SU3SS9S hvN U "U 5S hvN S v GM9 U(d`[TR*R-5US 9H9n U RHnU "U5S hvN M U "U SS9S hvN S v M; g g GNGN![a U RnGNf=fGNhNNNNMN<7f)z|Yield text strings representing a ``gettext`` PO (portable object) file. See `write_po()` for a more detailed description. rrF)rbreak_long_wordsz# )rsubsequent_indentrr'c3p># TRU5HnSUSUR5S3v M g7f)Nrr2r)wrapr^)rrr7comment_wrappers r_format_comment$generate_po.._format_comments6#((1DfXQtzz|nB/ /2s36c 3># [UR[[45(aUR(aUS[ URUTS9S3v US[ URSUTS9S3v US[ URSUTS9S3v [ TR5H)nURUnUS US S [ X1TS9S3v M+ gUR(aUS[ URUTS9S3v US[ URUTS9S3v US [ UR=(d SUTS9S3v g![a SnNf=f7f) Nzmsgctxt )rrrmsgid r msgid_plural rr'zmsgstr[dz] zmsgstr ) ridrrrrrrr#r)rFrrr#rCrs r_format_message$generate_po.._format_messagesm gjj4- 0 07??6Y^)_(``bccHF9WZZ]6QV#W"XXZ[ [HM)GJJqM&X]*^)__ab bW001 $^^C0F Awb6X]1^0__abb 27??6Y^)_(``bccHF9WZZe#T"UUWX XHGIgnn.B6Y^$_#``bc c" F s+B,E0E ?B E EEEE)rrNr)rc\US[US[5=(a US=(d S4$)Nrrr)rrJ)xs rgenerate_po..s*!A$ 1Q48M8VRSTURV8\Z\1]rkey/rrr2rz, r)r|rrz#~ )r')r _sort_messagesrheader_commentr(rr+rrsortedr8 TypeErrorrriseprr6r previous_idrrrvalues)rCrrrrrrr comment_widthheader_wrapperrrrFcomment_headerr-r7rlocsr8rrDr9norm_previous_idrs` ` @rrrls"#uqyEbM! NO uW\]N0dd&"'7;zz$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+++ gK-?LK0&A L7.L%L &A.sAKKrr )rr)rrs rr$r$sCH~H)  O J  / 0 Or)r#rIrKrI)r7rIrKz list[str])NNFNF)rrrzLocale | str | Noner str | Nonerrerr3rrerKr)r'r)r#rIrrIrrJrKrI)rrIrKrI)rFFFFFFT)rzSupportsWrite[bytes]rCrrrJrrerrer rer rerrerrerrerKrL)rCrrrerrerrerrerrer%Literal['message', 'location'] | NonerrJrKz Iterable[str])rzIterable[Message]rr4rKz list[Message])&rQ __future__rrir collections.abcrtypingrr babel.corerbabel.messages.catalogrr babel.utilr r r r _typeshedrr$r.r< Exceptionr>rUrrr!rrrrr rr$rrrr=s # $)3(!'J. >)X))()(XEBEBT#'! 9 *9 9 9 9  9  9 9x :: 0$:Kz(!"J !J J J J  J  JJJJJ J`""59j jj j  j  jj3j jjZr