XhcedZddlmZddlZddlZddlmZddlmZm Z ddl m Z ddl m Z mZddlmZmZerdd lmZmZdd lmZd d Zd d Zd!d ZGddeZGddZGddZ d" d#dZej<dZd dZ d$d%dZ!d&dZ" d' d(dZ#dddddddd d)dZ$d*dZ%y)+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) SupportsWritecXd}tjdj||ddS)zReverse `escape` the given string. >>> print(unescape('"Say:\\n \\"hello, world!\\"\\n"')) Say: "hello, world!" :param string: the string to unescape cL|jd}|dk(ry|dk(ry|dk(ry|S)Nn t r )group)matchms I/var/www/html/myenv/lib/python3.12/site-packages/babel/messages/pofile.pyreplace_escapesz!unescape..replace_escapes&s2 KKN 8 #X #Xz \\([\\trn"])r)recompilesub)stringrs runescaper#s+  ::o & * *?F1RL IIrcd|vrG|j}|jdr|dd}tt|}dj |St|S)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-3sX* v~))+   T ")!"-MHm,wwu~rcRd|vr"d|vr|jjSg}d}d}|D]U}|dk(r|r tdd}|dk(r|s tdd}-|dk(r|r||z }:|s=|j|d}Q||z }W|r|r td|j||S) 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  #XA   * MH)',  "WXX   X & rc$eZdZdZdfd ZxZS) PoFileErrorzDException thrown by PoParser when an invalid po file is encountered.cXt||d|||_||_||_y)Nz on )super__init__catalogr6lineno)selfmessagerAr6rB __class__s rr@zPoFileError.__init__s0 G9D12   r) rDstrrArr6rFrBintreturnNone)__name__ __module__ __qualname____doc__r@ __classcell__)rEs@rr=r=~sNrr=cleZdZddZddZddZddZddZddZddZ ddZ dd Z dd Z dd Z dd Zy )_NormalizedStringcBg|_|D]}|j|yN)_strsr5)rCargsargs rr@z_NormalizedString.__init__s$ "  C KK  rcV|jj|jyrR)rSr5strip)rCss rr5z_NormalizedString.appends !'')$rcTdjtt|jS)Nr&)r*r)r#rSrCs rr-z_NormalizedString.denormalizeswws8TZZ011rc,t|jSrR)boolrSrZs r__bool__z_NormalizedString.__bool__sDJJrcTtjj|jSrR)oslinesepr*rSrZs r__repr__z_NormalizedString.__repr__szztzz**rcD|sytt|t|S)Nr)r rFrCothers r__cmp__z_NormalizedString.__cmp__sCIs5z**rc*|j|dkDSNrrercs r__gt__z_NormalizedString.__gt__||E"Q&&rc*|j|dkSrgrhrcs r__lt__z_NormalizedString.__lt__rjrc*|j|dk\Srgrhrcs r__ge__z_NormalizedString.__ge__||E"a''rc*|j|dkSrgrhrcs r__le__z_NormalizedString.__le__rorc*|j|dk(Srgrhrcs r__eq__z_NormalizedString.__eq__rorc*|j|dk7Srgrhrcs r__ne__z_NormalizedString.__ne__rorN)rTrFrHrI)rXrFrHrI)rHrF)rHr\)rdobjectrHrG)rdrvrHr\)rJrKrLr@r5r-r]rarerirlrnrqrsrurrrPrPs> %2 ++ ''((((rrPcneZdZdZgdZdddZddZddZddZdddZ dddZ dd Z dd Z dd Z dd Zy ) 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_pluralcj||_||_d|_d|_||_|j yrg)rAignore_obsoletecounteroffset abort_invalid_reset_message_state)rCrArrs rr@zPoFileParser.__init__s3 .  * !!#rcg|_g|_g|_g|_g|_g|_d|_d|_d|_d|_ d|_ y)NF) messages translationsr7flags user_comments auto_commentscontextobsoletein_msgid in_msgstr in_msgctxtrZs rrz!PoFileParser._reset_message_statesR     rc |jjt|jdkDrt d|jD}n|jdj }t |ttfrt|jjDcgc]}d}}|jD]O\}}||jjk\r|jd|jd=|j ||<Qt |}n |jddj }|jr|jj nd}t||t|jt!|j"|j$|j&|jdz|}|j(r@|j*sC||jj(|jj-||<n||j|<|xj.dz c_|j1ycc}w)z Add a message to the catalog based on the current parser state and clear the state ready to process the next message. rc3<K|]}|jywrR)r-).0rs r z,PoFileParser._add_message..sAa!--/Asrr&z5msg has more translations than num_plurals of catalogN)rBr)rsortlenrtupler- isinstancelistrangerA num_plurals_invalid_pofilerrr r7setrrrrr_key_forrr)rCrz_r"idx translationr|rDs r _add_messagezPoFileParser._add_messages  t}}  !A4==AAEMM!$002E edE] +"' (@(@"ABQbBFB$($5$5 8 [$,,222((T[[:qr)557s  8 6]F&&q)!,88:F04 $,,**,$%dnn)=s4::,,d.@.@WX")+ ==''OV %%dll&;&;E7&KL")DLL    !!#'Cs$ H<c|jr|jsb|jd|jd|jdj d|jj dt dg|jyy)Nr&zmissing msgstr for msgid 'r')rrrrr-r5rPrrZs r_finish_current_messagez$PoFileParser._finish_current_messagesz ==$$$$R8RSWS`S`abScSoSoSqRrrs6tu!!((!->r-B)CD     rcr|jdr|j||y|j|||y)N")r(!_process_string_continuation_line_process_keyword_line)rCrBr6rs r_process_message_linez"PoFileParser._process_message_lines0 ??3   2 24 @  & &vtX >rc|jD]4} |j|r |t|dvr|t|d}n6|j ||dy|dvr|j ||_|dk(r||_|dvr3d|_d|_ |jjt|y|d k(rd|_ d|_ |jd rH|d djd d \}}|jjt!|t|gy|jjd t|gy|dk(rd|_t||_yy#t$r|j ||dYywxYw)N)r1[z$Keyword must be followed by a stringz0Start of line didn't match any expected keyword.)rzr|rz)rzr}FTr{rr]rr|) _keywordsr(r IndexErrorrrrrrrrr5rPrr3rrGr)rCrBr6rkeywordrUrmsgs rrz"PoFileParser._process_keyword_lines~~ G [??7+S\0Bj0Ps7|}-C   v/a b  * *  ( ( *   g  DK / /#DO DM MM !23!7 8  !DM!DN~~c"qr7==a0S!!((#c(4Ec4J)KL!!((!->s-C)DE  !"DO,S1DL"= [$$T63YZ [s/E''FFc|jr|jd}nL|jr|jdd}n-|jr |j }n|j ||dy|j|y)Nrrz6*BCNN))8T*:; <!"X  %QR)//4 0 !!$**,/ 0 !"X  %12hnn&G""))'2    % %d12hnn&6 7&! !s E77 FFc 8t|D]\}}|j}t|ts%|j |j j }|sN|jdrM|ddjdr&|j||ddjd |j||j|||j|js|js|j s |j"r[|j$j't)d|j*j'd t)dg|j-yyy#t$r'}|j||t|Yd}~d}~wwxYw) 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) enumeraterWrrFdecoderAcharsetr(rr2rr4rrrrrrrr5rPrr)rCfileobjrBr6excs rparsezPoFileParser.parseTs^ &g. 9LFD:: > j# )&1*Rx@ArN)FF)rArrr\rr\rHrI)rHrI)F)rIO[AnyStr] | Iterable[AnyStr]rHrI)rJrKrLrMrr@rrrrrrrrrrwrrryrysD I$  $@ ? '2R 86 @BrryFc`t|||}t|||}|j||S)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)rryr)rrrrrrrAparsers rread_por|s2lVFGDG '?- PF LL NrzL(\s+|[^\s\w]*\w+[a-zA-Z]-(?=\w+[a-zA-Z])|(?<=[\w\!\"\'\&\.\,\?])-{2,}(?=\w))cd|jddjddjddjdd jd d zS) 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 |r|dkDrt|}g}|jdD]}tt||z|kDrtj |}|j |sEg}d}|rott|ddz |z} || z|kr%|j |j|| z }n"|s|j |jn|ro|j dj||r|j |n|jd}t|dkr t|S|r|ds|d=|dxxdz cc<ddj|Dcgc]}|t|zc}zScc}w) aConvert 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_SEPr3reverser5popr*) r"prefixwidth prefixlenr,r6chunksbufsizelengths r normalizersq0 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 NrDr8rinclude_linenoinclude_previous no_location omit_headersort_byrbackslashreplace) generate_porrFencoderwrite) rrArrr sort_output sort_by_filerrrrr6s rwrite_porsspG '%)   dC ;;w0BCD d rrc#KrdkDrnd}t|dtdd} dfd } dfd } t| D]} | jsY|rj} rAdkDr._format_comments<#((1 0DfXQtzz|nB/ / 0s14c 3Kt|jttfr|jr |dt |j|d|dt |jd|d|dt |jd|dt jD],} |j|}|d |d d t ||d.y|jr |dt |j|d|dt |j|d|d t |jxsd|dy#t$rd}YwxYww) Nzmsgctxt )rrrmsgid r msgid_plural rr&zmsgstr[dz] zmsgstr ) ridrrrrrrr"r)rDrrr"rArs r_format_messagez$generate_po.._format_messagest gjj4- 07??6Y^)_(``bccHF9WZZ]6QV#W"XXZ[ [HM)GJJqM&X]*^)__ab bW001 c $^^C0F Awb6&X]1^0__abb  c7??6Y^)_(``bccHF9WZZe#T"UUWX XHGIgnn.B6Y^$_#``bc c" F s+B+E/E >BE EEEE)rrNr)rcH|dt|dtxr|dxsdfS)Nrrr)rrG)xs rzgenerate_po..s,!A$ 1Q48M8VRSTURV8\Z\1]rkey/rrr1rz, r)r|rrz#~ )r&)r _sort_messagesrheader_commentr'rr*rrsortedr7 TypeErrorrr_seprr5r previous_idrrrvalues)rArrrrrrr comment_widthheader_wrapperrrrDcomment_headerr,r6rlocsr7rrBr8norm_previous_idrs` ` @rrrls,"#uqyEbM! NO uW\]N0d&"'7;3zz$33N*5577D^0066E7!%5!1#$B' ',, 0G&w/ / / 0,, bA A   #3&7#6#6q#9GHI  7&&'!+#,W-@-@-C5#Q *];K:L+MVYZZZ"7+++ g3j %    # # %  G#00 4*7333 4&wu= = =J  Q 0 ; .#--  . C   [+4 =sCK. J? "K.,K- K.8KAK./K.K!A3K.7K$8AK.>K&?K.K(AK.K*K.2K,3 K.K.KK.KK.$K.&K.(K.*K.,K.czt|}|dk(r|j|S|dk(r|jd|S)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] rDr8c|jSrR)r7)rs rrz _sort_messages..s AKKrr)rr)rrs rrrsCH~H)  O J  / 0 Or)r"rFrHrF)r6rFrHz list[str])NNFNF)rrrzLocale | str | Noner str | Nonerr\rrrr\rHr)r&r)r"rFrrFrrGrHrF)rrFrHrF)rFFFFFFT)rzSupportsWrite[bytes]rArrrGrr\rr\rr\rr\rr\rr\rr\rHrI)rArrr\rr\rr\rr\rr\r%Literal['message', 'location'] | NonerrGrHz Iterable[str])rzIterable[Message]rrrHz list[Message])&rM __future__rr_rcollections.abcrtypingrr babel.corerbabel.messages.catalogrr babel.utilr r r r _typeshedrr#r-r; Exceptionr=rPryrr rrrrrrrrwrrrs # $)3(!'J. >)X))()(XEBEBT#'! 9 *9 9 9 9  9  9 9x 2:: 0$:Kz(!"J !J J J J  J  JJJJJ J`""59j jj j  j  jj3j jjZr