\c@sdZddlZddlZddlmZddlmZddlmZmZddl m Z ddl m Z ddl m Z dd lmZdd lmZmZdd lmZdd lmZdd lmZmZmZddlmZmZmZm Z m!Z!m"Z"dddgZ#ej$dej%Z&dZ'de(fdYZ)de*fdYZ+dZ,erdZ-ne Z-de(fdYZ.dS(s babel.messages.catalog ~~~~~~~~~~~~~~~~~~~~~~ Data structures for message catalogs. :copyright: (c) 2013-2019 by the Babel Team. :license: BSD, see LICENSE for more details. iN(t parse_header(t OrderedDict(tdatetimettime(tget_close_matches(tmessage_from_string(tcopy(t __version__(tLocaletUnknownLocaleError(tformat_datetime(t get_plural(tdistincttLOCALTZtFixedOffsetTimezone(t string_typest number_typestPY2tcmpt text_typet force_texttMessagetCatalogtTranslationErrors \% (?:\(([\w]*)\))? ( [-#0\ +]?(?:\*|[\d]+)? (?:\.(?:\*|[\d]+))? [hlL]? ) ([diouxXeEfFgGcrs%]) cCstjd|}tj|jdd}tj|}tj|}|jd}|dk r|d|d}}|d |d}} t |d} t |} t | } | d } | | 7} | | 9} t | }|j d |}n|S( Ns+^(?P.*?)(?P[+-]\d{4})?$Rs%Y-%m-%d %H:%Mttzoffsetiiit1i<ttzinfo( tretmatchRtstrptimetgrouptmktimeRt fromtimestamptNonetintRtreplace(tvalueRtttttstdtRt plus_minus_strestthours_offset_st mins_offset_st plus_minust hours_offsett mins_offsettnet_mins_offset((s5lib/python2.7/site-packages/babel/messages/catalog.pyt_parse_datetime_header,s"       c BseZdZdddddddddZdZdZdZdZdZ dZ d Z d Z d Z dd Zed ZedZedZRS(s0Representation of a single message in a catalog.uc Cs||_| r"|jr"d}n||_tt||_t||_|rq|jrq|jj dn|jj dtt||_ tt||_ t |tr|g|_nt||_||_| |_dS(s_Create 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 us python-formatN(uu(tidt pluralizabletstringtlistR t locationstsettflagst python_formattaddtdiscardt auto_commentst user_commentst isinstanceRt previous_idtlinenotcontext( tselfR1R3R5R7R;R<R>R?R@((s5lib/python2.7/site-packages/babel/messages/catalog.pyt__init__Os     cCs&dt|j|jt|jfS(Ns<%s %r (flags: %r)>(ttypet__name__R1R4R7(RA((s5lib/python2.7/site-packages/babel/messages/catalog.pyt__repr__tscCs"d}t||||S(s0Compare Messages, taking into account plural idscSsHt|tr2|jr2|jd|jp.dfS|j|jpDdfS(Nit(R=RR2R1R@(tobj((s5lib/python2.7/site-packages/babel/messages/catalog.pytvalues_to_comparezs(R(RAtotherRH((s5lib/python2.7/site-packages/babel/messages/catalog.pyt__cmp__xs cCs|j|dkS(Ni(RJ(RARI((s5lib/python2.7/site-packages/babel/messages/catalog.pyt__gt__scCs|j|dkS(Ni(RJ(RARI((s5lib/python2.7/site-packages/babel/messages/catalog.pyt__lt__scCs|j|dkS(Ni(RJ(RARI((s5lib/python2.7/site-packages/babel/messages/catalog.pyt__ge__scCs|j|dkS(Ni(RJ(RARI((s5lib/python2.7/site-packages/babel/messages/catalog.pyt__le__scCs|j|dkS(Ni(RJ(RARI((s5lib/python2.7/site-packages/babel/messages/catalog.pyt__eq__scCs|j|dkS(Ni(RJ(RARI((s5lib/python2.7/site-packages/babel/messages/catalog.pyt__ne__sc CsIttt|j|j|j|j|j|j|j |j |j f S(N( RtmapRR1R3R5R7R;R<R>R?R@(RA((s5lib/python2.7/site-packages/babel/messages/catalog.pytclones  cCs_ddlm}g}xB|D]:}y|||Wqtk rV}|j|qXqW|S(sRun 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. i(tcheckers(tbabel.messages.checkersRSRtappend(RAtcatalogRSterrorstcheckerte((s5lib/python2.7/site-packages/babel/messages/catalog.pytchecks  cCs d|jkS(sWhether the translation is fuzzy. >>> Message('foo').fuzzy False >>> msg = Message('foo', 'foo', flags=['fuzzy']) >>> msg.fuzzy True >>> msg :type: `bool`tfuzzy(R7(RA((s5lib/python2.7/site-packages/babel/messages/catalog.pyR[s cCst|jttfS(sWhether the message is plurizable. >>> Message('foo').pluralizable False >>> Message(('foo', 'bar')).pluralizable True :type: `bool`(R=R1R4ttuple(RA((s5lib/python2.7/site-packages/babel/messages/catalog.pyR2s cCs>|j}t|ttfs*|g}ntd|DS(sWhether 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`css|]}tj|VqdS(N(t PYTHON_FORMATtsearch(t.0R1((s5lib/python2.7/site-packages/babel/messages/catalog.pys s(R1R=R4R\tany(RAtids((s5lib/python2.7/site-packages/babel/messages/catalog.pyR8s  (((((N(RDt __module__t__doc__R!RBRERJRKRLRMRNRORPRRRZtpropertyR[R2R8(((s5lib/python2.7/site-packages/babel/messages/catalog.pyRLs  $           cBseZdZRS(s_Exception thrown by translation checkers when invalid message translations are encountered.(RDRbRc(((s5lib/python2.7/site-packages/babel/messages/catalog.pyRsu# Translations template for PROJECT. # Copyright (C) YEAR ORGANIZATION # This file is distributed under the same license as the PROJECT project. # FIRST AUTHOR , YEAR. #cCsdt|jd}i}xB|jD]4\}}|jd}|jd}|||sLANGUAGE sutf-8RsYEAR-MO-DA HO:MI+ZONEN(tdomaintlocalet_header_commentRt _messagestprojecttversiontcopyright_holdertmsgid_bugs_addresstlast_translatort language_teamtcharsetR!RtnowR R=RR#t creation_datet revision_dateR[tobsoletet _num_pluralst _plural_expr(RARrRqtheader_commentRuRvRwRxR}R~RyRzR{R[((s5lib/python2.7/site-packages/babel/messages/catalog.pyRBs2            cCs|dkr"d|_d|_dSt|trMt||_||_dSt|trt||_ytj||_Wntk rd|_nXdSt d|dS(NsF`locale` must be a Locale, a locale identifier string, or None; got %r( R!t_locale_identifiert_localeR=RRRtparseR t TypeError(RARr((s5lib/python2.7/site-packages/babel/messages/catalog.pyt _set_locale/s       cCs|jS(N(R(RA((s5lib/python2.7/site-packages/babel/messages/catalog.pyt _get_localeDscCs|jS(N(R(RA((s5lib/python2.7/site-packages/babel/messages/catalog.pyt_get_locale_identifierGscCs|j}tjtjd}t|jdrH|jjd}n|jd|jjd|j jd|jd|j }|j r|j j n|j }|r|jdd|}n|S( Ns%YtstrftimeRnRotYEARRpsTranslations templates%s translations(RsRR|R RthasattrR~R#RuRvRwRrt english_nametlocale_identifier(RAtcommenttyeart locale_name((s5lib/python2.7/site-packages/babel/messages/catalog.pyt_get_header_commentMs  cCs ||_dS(N(Rs(RAR3((s5lib/python2.7/site-packages/babel/messages/catalog.pyt_set_header_comment[stdocs 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` cCsg}|jdd|j|jff|jd|jf|jdt|jdddft|jtt ft r|jdt|jdddfn|jd|jf|jd |j f|j r|jd t |j fn|j rBd |jkrB|jd |jjd t |j fn|jd |jf|jdk r|jd |jfn|jd|jdd|jf|jd|jddtf|S(NsProject-Id-Versions%s %ssReport-Msgid-Bugs-TosPOT-Creation-Datesyyyy-MM-dd HH:mmZRrtensPO-Revision-DatesLast-TranslatortLanguagetLANGUAGEs Language-Teams Plural-Formss MIME-Versions1.0s Content-Typestext/plain; charset=%ssContent-Transfer-Encodingt8bits Generated-Bys Babel %s (s MIME-Versions1.0(sContent-Transfer-EncodingR(RURuRvRxR R}R=R~Rttime_RRyRtstrRzR#RrR!t plural_formsR{Ro(RARj((s5lib/python2.7/site-packages/babel/messages/catalog.pyt_get_mime_headerss8           cCsx|D]\}}t|jd|j}t|d|j}|dkr|jd}dj|d |_|d|_q|dkr||_q|dkr||_q|dkr|j d d }|j |q|d kr||_ q|d kr=t |\}}d |kr|d j|_qq|dkrt d|\}}t |jdd|_|jdd|_q|dkrt||_q|dkrd|krt||_qqqWdS(Ntencodingsproject-id-versiont u isreport-msgid-bugs-toslast-translatortlanguaget-t_s language-teams content-typeR{s plural-formss ;tnpluralsitplurals(n != 1)spot-creation-datespo-revision-dateR(RtlowerR{tsplittjoinRuRvRxRyR#RRzRR"tgetRRR0R}R~(RARjRlR$tpartstmimetypetparamsR((s5lib/python2.7/site-packages/babel/messages/catalog.pyt_set_mime_headerss:              s The MIME headers of the catalog, used for the special ``msgid ""`` entry. The behavior of this property changes slightly depending on whether a locale is set or not, the latter indicating that the catalog is actually a template for actual translations. Here's an example of the output for such a catalog template: >>> from babel.dates import UTC >>> 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` cCsG|jdkr@d}|jr4t|jd}n||_n|jS(sThe number of plurals used by the catalog or locale. >>> Catalog(locale='en').num_plurals 2 >>> Catalog(locale='ga').num_plurals 5 :type: `int`iiN(RR!RrR (RAtnum((s5lib/python2.7/site-packages/babel/messages/catalog.pyt num_pluralss   cCsG|jdkr@d}|jr4t|jd}n||_n|jS(s`The 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: `string_types`s(n != 1)iN(RR!RrR (RAtexpr((s5lib/python2.7/site-packages/babel/messages/catalog.pyt plural_exprs   cCsd|j|jfS(sReturn 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`snplurals=%s; plural=%s(RR(RA((s5lib/python2.7/site-packages/babel/messages/catalog.pyRs cCs|j||jkS(s?Return whether the catalog has a message with the specified ID.(t_key_forRt(RAR1((s5lib/python2.7/site-packages/babel/messages/catalog.pyt __contains__"scCs t|jS(seThe number of messages in the catalog. This does not include the special ``msgid ""`` entry.(tlenRt(RA((s5lib/python2.7/site-packages/babel/messages/catalog.pyt__len__&sccsg}x.|jD]#\}}|jd||fqWt}|jrY|dhO}ntddj|d|Vx|jD]}|j|VqWdS(sIterates through all the entries in the catalog, in the order they were added, yielding a `Message` object for every entry. :rtype: ``iterator``s%s: %sR[us R7N(t mime_headersRUR6R[RRRt(RAtbufRlR$R7tkey((s5lib/python2.7/site-packages/babel/messages/catalog.pyt__iter__,s  cCs<d}|jrd|j}ndt|j|j|fS(NRFs %ss <%s %r%s>(RrRCRDRq(RARr((s5lib/python2.7/site-packages/babel/messages/catalog.pyRE;s cCs|j|dS(s)Delete the message with the specified ID.N(tdelete(RAR1((s5lib/python2.7/site-packages/babel/messages/catalog.pyt __delitem__AscCs |j|S(sUReturn the message with the specified ID. :param id: the message ID (R(RAR1((s5lib/python2.7/site-packages/babel/messages/catalog.pyt __getitem__EscCst|tstd|j||j}|jj|}|r|jrv|j rv|j|_|j |_ nt t |j |j |_ t t |j |j |_ t t |j|j|_|j|jO_|}n|dkrSt|j j|_djg|jD]}d|j^q"|_|j|_nVt|t tfrt|j t tfstdt|j n||j|>> 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 sexpected a Message objectRFs s# %ssExpected sequence but got %sN(R=RtAssertionErrorRR@RtRR2R1R3R4R R5R;R<R7RmRgRRtrstripRR[R\RC(RAR1tmessageRtcurrenttc((s5lib/python2.7/site-packages/babel/messages/catalog.pyt __setitem__Ls0       )c Cs>t||t|||||d|d| } | ||<| S(stAdd 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 R?R@(RR4( RAR1R3R5R7R;R<R>R?R@R((s5lib/python2.7/site-packages/babel/messages/catalog.pyR9~s   ccsDx=|jjD],}|jd|}|r||fVqqWdS(sBRun 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: ``iterator`` RVN(RttvaluesRZ(RARRW((s5lib/python2.7/site-packages/babel/messages/catalog.pyRZs cCs|jj|j||S(sReturn the message with the specified ID and context. :param id: the message ID :param context: the message context, or ``None`` for no context (RtRR(RAR1R@((s5lib/python2.7/site-packages/babel/messages/catalog.pyRscCs2|j||}||jkr.|j|=ndS(sDelete the message with the specified ID and context. :param id: the message ID :param context: the message context, or ``None`` for no context N(RRt(RAR1R@R((s5lib/python2.7/site-packages/babel/messages/catalog.pyRscsjjt_g}|sxtgD]5}|r7|jr7j||jf^q7}ntfd}x|D]}|jrj|j|j} | kr||| | q|t krt | t r| d} n| } t | j j|jd} | r| d} || } | dk rp| | f} n||| | qqn||j>> 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 cs|j}t}||kryt}j|j|}t|jtrd|jg|_qt |j|_nj |d}|j |_ rt t |j|_nt|jt tfrat|j t tfst}t|j gdgt|jd|_ qt|j jkrt}t|j t|j  |_ qn1t|j t tfrt}|j d|_ n|j|jO_|r|jdhO_n||jR4tpopR!R3R R<R\RRR7(RtoldkeytnewkeyR[toldmsg(t fuzzy_matchestkeep_user_commentstmessagest remainingRA(s5lib/python2.7/site-packages/babel/messages/catalog.pyt_merges8    -%iiN(RtRRtdictR3RR@R6R1RR=R\RRtstriptkeysR!RRR}(RAttemplatetno_fuzzy_matchingtupdate_header_commentRtfuzzy_candidatestmsgidRRRtmatchkeytmatchesRtnewctxt((RRRRRAs5lib/python2.7/site-packages/babel/messages/catalog.pytupdatesF5   E #          cCsG|}t|ttfr(|d}n|dk rC||f}n|S(sThe key for a message is just the singular ID even for pluralizable messages, but is a ``(msgid, msgctxt)`` tuple for context-specific messages. iN(R=R4R\R!(RAR1R@R((s5lib/python2.7/site-packages/babel/messages/catalog.pyRIs   N(((((($RDRbRcR!tDEFAULT_HEADERRRBRRRRdRrRRRRRRRRRRRRRRERRRR9RZRRRRR(((s5lib/python2.7/site-packages/babel/messages/catalog.pyRsH   6         1        2    (/RcRRtcgiRt collectionsRRRtdifflibRtemailRRtbabelRRot babel.coreRR t babel.datesR tbabel.messages.pluralsR t babel.utilR R Rt babel._compatRRRRRRt__all__tcompiletVERBOSER]R0tobjectRt ExceptionRRRmR(((s5lib/python2.7/site-packages/babel/messages/catalog.pyt s2  .