MhcedZddlmZddlZddlZddlmZddlmZm Z ddl m Z ddl m Z mZddlmZmZerdd lmZmZdd lmZdDdZdDdZdEdZGddeZGddZGddZ dFdGd%Zejd&ZdDd'Z dHdId-Z!dJd/Z" dKdLd:Z#dd0ddddd)d;dMd?Z$dNdCZ%dS)Oz 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) SupportsWritestringstrreturnchd}tjd||ddS)zReverse `escape` the given string. >>> print(unescape('"Say:\\n \\"hello, world!\\"\\n"')) Say: "hello, world!" :param string: the string to unescape c`|d}|dkrdS|dkrdS|dkrdS|S)Nn t r )group)matchms U/var/www/html/test/jupyter/venv/lib/python3.11/site-packages/babel/messages/pofile.pyreplace_escapesz!unescape..replace_escapes&s@ KKNN 884 #XX4 #XX4z \\([\\trn"])r)recompilesub)rrs runescaper%s;    :o & & * *?F1R4L I IIr cd|vr]|}|dr |dd}tt|}d|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/3so* v~~))++   T " " .)!""-MHm,,wwu~~r line list[str]cd|vr*d|vr&|Sg}d}d}|D]c}|dkr|rtdd}|dkr|stdd}6|dkr"|r||z }D|r||d}^||z }d|r&|rtd|||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)r0 locationslocation in_filenamecs r_extract_locationsr>RsJt 4 4{{}}""$$$IHK '' == X "WXXXK  (]] U "TUUUK  #XX A    *** MHH  ' X "WXXX   X & & & r c$eZdZdZd fd ZxZS) PoFileErrorzDException thrown by PoParser when an invalid po file is encountered.messagercatalogrr0linenointrNonec~t|d|||_||_||_dS)Nz on )super__init__rBr0rC)selfrArBr0rC __class__s rrHzPoFileError.__init__sB G1111222   r ) rArrBrr0rrCrDrrE)__name__ __module__ __qualname____doc__rH __classcell__)rJs@rr@r@~sCNNr r@cneZdZddZddZddZdd Zdd ZddZddZ ddZ ddZ ddZ ddZ ddZdS)_NormalizedStringargsrrrEcHg|_|D]}||dSN)_strsr9)rIrRargs rrHz_NormalizedString.__init__s7 "   C KK      r sc^|j|dSrT)rUr9strip)rIrWs rr9z_NormalizedString.appends& !''))$$$$$r c\dtt|jS)Nr()r,r+r%rUrIs rr/z_NormalizedString.denormalizes wws8TZ00111r boolc*t|jSrT)r\rUr[s r__bool__z_NormalizedString.__bool__sDJr cJtj|jSrT)oslinesepr,rUr[s r__repr__z_NormalizedString.__repr__sztz***r otherobjectrDc^|sdStt|t|S)Nr)r rrIrcs r__cmp__z_NormalizedString.__cmp__s+ 1CIIs5zz***r c4||dkSNrrgrfs r__gt__z_NormalizedString.__gt__||E""Q&&r c4||dkSrirjrfs r__lt__z_NormalizedString.__lt__rlr c4||dkSrirjrfs r__ge__z_NormalizedString.__ge__||E""a''r c4||dkSrirjrfs r__le__z_NormalizedString.__le__rqr c4||dkSrirjrfs r__eq__z_NormalizedString.__eq__rqr c4||dkSrirjrfs r__ne__z_NormalizedString.__ne__rqr N)rRrrrE)rWrrrE)rr)rr\)rcrdrrD)rcrdrr\)rKrLrMrHr9r/r^rbrgrkrnrprsrurwr rrQrQs %%%%2222    ++++++++ ''''''''((((((((((((((((((r rQcpeZdZdZgdZddd Zdd Zdd ZddZdddZ dddZ ddZ ddZ ddZ ddZdS) 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_pluralFrBrignore_obsoleter\ abort_invalidrrEct||_||_d|_d|_||_|dSri)rBrcounteroffsetr_reset_message_state)rIrBrrs rrHzPoFileParser.__init__s? .  * !!#####r cg|_g|_g|_g|_g|_g|_d|_d|_d|_d|_ d|_ dS)NF) messages translationsr:flags user_comments auto_commentscontextobsoletein_msgid in_msgstr in_msgctxtr[s rrz!PoFileParser._reset_message_statesV     r c |jt|jdkrt d|jD}n|jd}t |ttfrdt|j j D}|jD]I\}}||j j kr| d|j d2|||<Jt |}n%|jdd}|j r|j nd}t||t|jt!|j|j|j|j dz|}|jr0|js(||j j|j ||<n ||j |<|xjdz c_|dS) 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|]}|VdSrT)r/).0rs r z,PoFileParser._add_message..s*AAa!--//AAAAAAr rcg|]}dSr(rx)r_s r z-PoFileParser._add_message..sBBBQbBBBr r(z5msg has more translations than num_plurals of catalogN)rCr)rsortlenrtupler/ isinstancelistrangerB num_plurals_invalid_pofilerrr r:setrrrrr_key_forrr)rIr{ridx translationr}rAs r _add_messagezPoFileParser._add_messages    t}   ! !AA4=AAAAAEEM!$0022E edE] + + ;BB% (@"A"ABBBF$($5 8 8 [$,222((T[:qrrr)5577s 6]]FF&q)!,88::F04 F$,**,,,$%dn)=)=s4:,d.@WX")+++ = *' WOV %dl&;&;E7&K&KL")DL    !!#####r c|jr|jsf|d|jd|jdd|jdt dg|dSdS)Nr(zmissing msgstr for msgid 'r')rrrrr/r9rQrr[s r_finish_current_messagez$PoFileParser._finish_current_messages = $ E$$R6tSWS`abScSoSoSqSq6t6t6tuuu!((!->r-B-B)CDDD           r c|dr|||dS||||dS)N")r*!_process_string_continuation_line_process_keyword_line)rIrCr0rs r_process_message_linez"PoFileParser._process_message_linesP ??3   ?  2 24 @ @ @ @ @  & &vtX > > > > >r c|jD]o} ||r0|t|dvr|t|d}nAI#t$r|||dYlwxYw|||ddS|dvr|||_|dkr||_|dvr7d|_d|_ |j t|dS|d krd|_ d|_ |d rY|d dd d \}}|j t!|t|gdS|j d t|gdS|dkrd|_t||_dSdS)N)r5[z$Keyword must be followed by a stringz0Start of line didn't match any expected keyword.)r{r}r{)r{r~FTr|rr]rr}) _keywordsr*r IndexErrorrrrrrrrr9rQrr7rrDr)rIrCr0rkeywordrVrmsgs rrz"PoFileParser._process_keyword_lines~  G [??7++S\\0Bj0P0Ps7||}}-CE [ [ [$$T63YZZZZZ [  v/a b b b F * * *  ( ( * * *   g   DK / / /#DO DM M !23!7!7 8 8 8 8 8  !DM!DN~~c"" Fqrr7==a00S!((#c((4Ec4J4J)KLLLLL!((!->s-C-C)DEEEEE  ! !"DO,S11DLLL" !sAA!A54A5c|jr|jd}nC|jr|jdd}n(|jr|j}n|||ddS||dS)Nr!rzrfindrDr8r:r9r6r7rrYrr)rIr0r;posrCflagcomments r_process_commentzPoFileParser._process_comment9s  $$&&& 8  s # # 8.tABBx88 < <nnS))!88!!$XcAghh%7!8!8%!!! !N))8DSD>6*BCCCCN))8T*:;;;; < <!""X  % % 8QRR))//44 0 0 !!$**,,//// 0 0 !""X  % % 8122hnn&&G 3"))'22222 3 3   % %d122hnn&6&6 7 7 7 7 7s'B BBfileobjIO[AnyStr] | Iterable[AnyStr]c t|D]\}}|}t|ts||jj}|sQ|dr|dddr3|||dd d | |#t$r/}| ||t|Yd}~d}~wwxYw|||!| |js{|js|js|jrh|jt)d|jd t)dg|dSdSdS) 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) enumeraterYrrdecoderBcharsetr*rr6rr8rrrrrrrr9rQrr)rIrrCr0excs rparsezPoFileParser.parseTs &g.. 9 9LFD::<> > j# @&1*@@@@AAAAAr N)FF)rBrrr\rr\rrE)rrE)F)rrrrE)rKrLrMrNrrHrrrrrrrrrrxr rrzrzs I$$$$$     $$$$@    ????? '2'2'2'2'2R    88886    @BBBBBBr rzFrrlocaleLocale | str | Nonedomain str | Nonerr\rrrcxt|||}t|||}|||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 )rrr)r)rrzr)rrrrrrrBparsers rread_por|sDlVFGDDDG '?- P P PF LL Nr zL(\s+|[^\s\w]*\w+[a-zA-Z]-(?=\w+[a-zA-Z])|(?<=[\w\!\"\'\&\.\,\?])-{2,}(?=\w))cd|dddddddd d 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)rs rescapers] FNN400"74//"74//"74//"74//  00r r(LprefixwidthrDc|rW|dkrPt}g}|dD]'}tt||z|krt|}||rg}d}|rtt|ddz |z} || z|kr-|||| z }n*|s'||n||d||||)n|d}t|dkrt|S|r|ds|d=|dxxdz cc<ddfd |DzS) 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 rTrr!r(rrz"" c4g|]}t|zSrx)r)rr0rs rrznormalize.. s$III4 5IIIr ) rr)rWORD_SEPr7reverser9popr,) rrr prefixlenr.r0chunksbufsizelengths ` r normalizers0 (KK %%d++ # #D6$<<  9,u44!--   /CD "!$VF2J%7%7!8!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 NrAr;rrrrrsort_byrbackslashreplace) generate_porrencoderwrite) rrBrrrrrrrrrr0s rwrite_porspG '%)      dC  D;;w0BCCD d  r rr%Literal['message', 'location'] | None Iterable[str]c#Krdkrnd}t|dtdd} dfd } dfd } t| D]&} | js_|r j} rLdkrFg}| D]}|| |z }d |} | d V| jD]}| |Ed {V| jD]}| |d Ed {V|sg} t| j d}n#t$r | j }YnwxYw|D]Y\}}| tjd}t|}|r |r|d|d}||vr||Z| d|dEd {V| jr0dddgt| jd V| jr||rz| dt'| jddEd {Vt)| jdkr2t'| jd}| d|dEd {V| | Ed {Vd V(|s]tj| D]6} | jD]}| |Ed {V| | dEd {Vd V5d Sd S)zYield text strings representing a ``gettext`` PO (portable object) file. See `write_po()` for a more detailed description. rrF)rbreak_long_wordsz# )rsubsequent_indentrr(c3vK|D]}d|d|dV dS)Nrr5r)wraprY)rrr0comment_wrappers r_format_commentz$generate_po.._format_commentsX#((11 0 0D/f//tzz||/// / / / / 0 0r c 3Kt|jttfr|jr|dt |j|dV|dt |jd|dV|dt |jd|dVt jD]A} |j|}n#t$rd}YnwxYw|d |d d t ||dVBdS|jr|dt |j|dV|dt |j|dV|d t |jpd|dVdS) Nzmsgctxt )rrrmsgid r msgid_plural rr(zmsgstr[dz] zmsgstr ) ridrrrrrrrr)rArrrrBrs r_format_messagez$generate_po.._format_messages gj4- 0 0 d dcc7?6Y^)_)_)_cccccc[[9WZ]6QV#W#W#W[[[ [ [ [bb)GJqM&X]*^*^*^bbb b b bW011 c c $^C0FF!   FFF bbbbb6&X]1^1^1^bbbbbbb  c c dcc7?6Y^)_)_)_ccccccXX9WZe#T#T#TXXX X X XccIgn.B6Y^$_$_$_ccc c c c c cs, B:: C C )rrNr)rc\|dt|dtr|dpdfS)Nrrr!)rrD)xs rzgenerate_po..s/!A$ 1Q48M8M8VRSTURV8\Z\1]r key/rrr5rz, r)r|rrz#~ r)r _sort_messagesrheader_commentr)rr,rrsortedr: TypeErrorrr`seprr9r previous_idrrrvalues)rBrrrrrrr comment_widthheader_wrapperrrrAcomment_headerr.r0rlocsr:rrCr;norm_previous_idrs` ` @rrrls"#8uqyyEEbM! NNNO uW\]]]N000000ddddddd&"'7;;;33z ( $3N 2*557777D^00666EE!%5!1!1#''' ' ' ', 0 0G&w// / / / / / / / /, < .sAKr r )rr)rrs rr r sQH~~H)  J   // 000 Or )rrrr)r0rrr1)NNFNF)rrrrrrrr\rrrr\rr)r(r)rrrrrrDrr)rrrr)rFFFFFFT)rrrBrrrDrr\rr\rr\rr\rr\rr\rr\rrE)rBrrr\rr\rr\rr\rr\rrrrDrr)rrrrrr)&rN __future__rr`r"collections.abcrtypingrr babel.corerbabel.messages.catalogrr babel.utilr r r r _typeshedrr%r/r> Exceptionr@rQrzrr#rrrrrrr rxr rr%s  #""""" $$$$$$))))))))33333333(((((((((!!!!!!!!''''''JJJJ.    >))))X))()()()()()()()(XEBEBEBEBEBEBEBEBT#'! 99999x 2:  0000$:K:K:K:K:Kz(!"JJJJJ`""59jjjjjjZr