o e@s^UdZddlmZddlZddlZddlmZddlmZm Z ddl m Z ddl m Z ddl mZdd lmZdd lmZdd lmZdd lmZmZdd lmZddlmZddlmZmZm Z m!Z!er{ddl"m#Z#e$e%e$dfBe&e$BZ'de(d<gdZ)d*ddZ*e+dej,Z-d+ddZ.Gd d!d!Z/Gd"d#d#e0Z1d$Z2d,d&d'Z3Gd(d)d)Z4dS)-z babel.messages.catalog ~~~~~~~~~~~~~~~~~~~~~~ Data structures for message catalogs. :copyright: (c) 2013-2023 by the Babel Team. :license: BSD, see LICENSE for more details. ) annotationsN) OrderedDict)IterableIterator)copy)SequenceMatcher)message_from_string)nlargest) TYPE_CHECKING) __version__)LocaleUnknownLocaleError)format_datetime) get_plural)LOCALTZFixedOffsetTimezone_cmpdistinct) TypeAlias.r _MessageID)MessageCatalogTranslationError333333?cCs|dks td|d|krdksntd|g}tdd}|||D]"}||||krM||krM||krM|||fq+t||}dd |DS) zA modified version of ``difflib.get_close_matches``. It just passes ``autojunk=False`` to the ``SequenceMatcher``, to work around https://github.com/python/cpython/issues/90825. rzn must be > 0: gg?zcutoff must be in [0.0, 1.0]: F)ZautojunkcSsg|]\}}|qSr).0ZscorexrrFD:\Projects\ConvertPro\env\Lib\site-packages\babel/messages/catalog.py :sz%get_close_matches..) ValueErrorrZset_seq2Zset_seq1Zreal_quick_ratioZ quick_ratioratioappendr )word possibilitiesncutoffresultsrrrrget_close_matches#s        r)z \% (?:\(([\w]*)\))? ( [-#0\ +]?(?:\*|[\d]+)? (?:\.(?:\*|[\d]+))? [hlL]? ) ([diouxXeEfFgGcrs%]) valuestrreturndatetime.datetimec Cstd|}tj|dd}|d}|durV|d|dd}}|dd|dd}}t|d}t|} t|} | d } | | 7} | |9} t| }|j|d }|S) Nz+^(?P.*?)(?P[+-]\d{4})?$datetimez%Y-%m-%d %H:%Mtzoffsetr1<tzinfo)rematchr.strptimegroupintrreplace) r*r7dtr/Z plus_minus_srestZhours_offset_sZ mins_offset_sZ plus_minusZ hours_offsetZ mins_offsetZnet_mins_offsetrrr_parse_datetime_headerIs   r>c@seZdZdZ        dddZd?ddZd@d!d"Zd@d#d$Zd@d%d&Z d@d'd(Z d@d)d*Z d@d+d,Z dAd-d.Z dBd/d0ZdCdDd4d5ZedEd6d7ZedEd8d9ZedEd:d;ZdS)Frz0Representation of a single message in a catalog.rNidrstring_MessageID | None locationsIterable[tuple[str, int]]flags Iterable[str] auto_comments user_comments previous_idlineno int | Nonecontext str | Noner,Nonec Cs||_|s |jr d}||_tt||_t||_|r%|jr%|j dn|j dtt||_ tt||_ t |trC|g|_nt||_||_| |_dS)a_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 )r?r?z python-formatN)r@ pluralizablerAlistrrCsetrE python_formatadddiscardrGrH isinstancer+rIrJrL) selfr@rArCrErGrHrIrJrLrrr__init__js         zMessage.__init__r+cCs&dt|jd|jdt|jdS)N< z (flags: z)>)type__name__r@rPrErVrrr__repr__s&zMessage.__repr__otherobjectr:cCsdd}t||||S)z0Compare Messages, taking into account plural idscSs4t|tr|jr|jd|jpdfS|j|jpdfS)Nrr?)rUrrOr@rL)objrrrvalues_to_comparesz*Message.__cmp__..values_to_compare)r)rVr^rarrr__cmp__szMessage.__cmp__boolcCs||dkSNrrbrVr^rrr__gt__zMessage.__gt__cCs||dkSrdrerfrrr__lt__rhzMessage.__lt__cCs||dkSrdrerfrrr__ge__rhzMessage.__ge__cCs||dkSrdrerfrrr__le__rhzMessage.__le__cCs||dkSrdrerfrrr__eq__rhzMessage.__eq__cCs||dkSrdrerfrrr__ne__rhzMessage.__ne__cCst|tsJ|j|jkS)z[Checks whether messages are identical, taking into account all properties. )rUr__dict__rfrrr is_identicals zMessage.is_identicalc Cs2ttt|j|j|j|j|j|j|j |j |j f SN) rmaprr@rArCrErGrHrIrJrLr\rrrclones z Message.clonecatalogCatalog | Nonelist[TranslationError]c CsZddlm}g}|D] }z|||Wq ty*}z ||WYd}~q d}~ww|S)aRun 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. r)checkersN)Zbabel.messages.checkersrvrr")rVrsrverrorscheckererrrchecks z Message.checkcCs d|jvS)aWhether the translation is fuzzy. >>> Message('foo').fuzzy False >>> msg = Message('foo', 'foo', flags=['fuzzy']) >>> msg.fuzzy True >>> msg :type: `bool`fuzzyrEr\rrrr{s z Message.fuzzycCst|jttfS)zWhether the message is plurizable. >>> Message('foo').pluralizable False >>> Message(('foo', 'bar')).pluralizable True :type: `bool`)rUr@rPtupler\rrrrOs zMessage.pluralizablecCs,|j}t|ttfs |g}tdd|DS)zWhether 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|]}t|VqdSrp) PYTHON_FORMATsearch)rr@rrr sz(Message.python_format..)r@rUrPr}any)rVZidsrrrrRs zMessage.python_format)r?rrrrrNN)r@rrArBrCrDrErFrGrFrHrFrIrrJrKrLrMr,rNr,r+)r^r_r,r:)r^r_r,rc)r^rr,rc)r,rrp)rsrtr,ru)r,rc)r[ __module__ __qualname____doc__rWr]rbrgrirjrkrlrmrorrrzpropertyr{rOrRrrrrrgs8 /             rc@seZdZdZdS)rz_Exception thrown by translation checkers when invalid message translations are encountered.N)r[rrrrrrrrsrz# Translations template for PROJECT. # Copyright (C) YEAR ORGANIZATION # This file is distributed under the same license as the PROJECT project. # FIRST AUTHOR , YEAR. #dict[str, str]cCs&ddlm}|}||d<t|S)Nr)r content-type) email.messagerdict get_params)r*rmrrrparse_separated_headers  rc @seZdZdZddeddddddddddf dwddZdxddZdyddZdzd d!Ze eeZ e eZ d{d#d$Z d|d&d'Z e e e d(d)Zd}d+d,Zd~dd3d4Zdd7d8Ze eed9d)Ze dd;d<Ze d{d=d>Ze d{d?d@ZddCdDZddEdFZddHdIZd{dJdKZddLdMZddOdPZddRdSZ  T T T T T  ddd`daZddcddZdddfdgZdddhdiZ j j dddodpZ!dddrdsZ"ddudvZ#dS)rz$Representation of a message catalog.NTlocalestr | Locale | NonedomainrMheader_commentprojectversioncopyright_holdermsgid_bugs_address creation_datedatetime.datetime | str | None revision_date6datetime.datetime | datetime.time | float | str | Nonelast_translator language_teamcharsetr{rcr,rNcCs||_||_||_t|_|pd|_|pd|_|pd|_|pd|_| p$d|_ | p*d|_ | p0d|_ |dur=t j t}nt|t j rL|jsL|jtd }||_| durVd } nt| t j re| jse| jtd } | |_| |_t|_d|_d|_dS) aDInitialize the catalog object. :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 header_comment: the header comment as string, or `None` for the default header :param project: the project's name :param version: the project's version :param copyright_holder: the copyright holder of the catalog :param msgid_bugs_address: the email address or URL to submit bug reports to :param creation_date: the date the catalog was created :param revision_date: the date the catalog was revised :param last_translator: the name and email of the last translator :param language_team: the name and email of the language team :param charset: the encoding to use in the output (defaults to utf-8) :param fuzzy: the fuzzy bit on the catalog header PROJECTVERSION ORGANIZATIONz EMAIL@ADDRESSzFULL NAME zLANGUAGE utf-8Nr4zYEAR-MO-DA HO:MI+ZONE)rr_header_commentr _messagesrrrrrrrr.nowrrUr5r;rrr{obsolete _num_plurals _plural_expr)rVrrrrrrrrrrrrr{rrrrWs6$          zCatalog.__init__Locale | str | NonecCs|dur d|_d|_dSt|trt||_||_dSt|tr>> 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` )doclist[tuple[str, str]]cCsVg}|d|jd|jf|d|jf|dt|jdddft|jtjtj t t fr?|dt|jdddfn|d|jf|d |j f|j r\|d t|j f|j rtd |jvrt|d |jd t|j fn|d |jf|jdur|d |jf|d|dd|jf|d|ddtdf|S)NzProject-Id-VersionrYzReport-Msgid-Bugs-TozPOT-Creation-Datezyyyy-MM-dd HH:mmZen)rzPO-Revision-DatezLast-TranslatorZLanguageLANGUAGEz Language-Teamz Plural-Forms)z MIME-Versionz1.0z Content-Typeztext/plain; charset=)zContent-Transfer-Encoding8bitz Generated-ByzBabel  )r"rrrrrrUrr.timer:floatrrr+rr;r plural_formsrr)rVheadersrrr_get_mime_headerss@   zCatalog._get_mime_headersrstrictr( str | bytesencodingrwcCs,t|tr|St|tr|||St|Srp)rUr+bytesdecode)rVr(rrwrrr _force_texts   zCatalog._force_textrIterable[tuple[str, str]]cCsF|D]\}}|j||jd}|j||jd}|dkr1|d}d|dd|_|d|_q|dkr9||_q|dkrA||_q|dkrQ| dd }| |q|d krY||_ q|d krmt |}d |vrl|d |_q|d krt d|}t |dd|_|dd|_q|dkrt||_q|dkrd|vrt||_qdS)N)rzproject-id-versionrYzreport-msgid-bugs-tozlast-translatorlanguage-_z language-teamrrz plural-formsz ;Znpluralsr1plural(n != 1)zpot-creation-datezpo-revision-dater)rlowerrsplitjoinrrrrr;rrrr:getrrr>rr)rVrnamer*partsparamsrrr_set_mime_headerss@       zCatalog._set_mime_headersa 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 >>> from datetime import datetime >>> 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` r:cC.|jdurd}|jrt|jd}||_|jS)zThe number of plurals used by the catalog or locale. >>> Catalog(locale='en').num_plurals 2 >>> Catalog(locale='ga').num_plurals 5 :type: `int`Nr1r)rrr)rVnumrrr num_plurals(s zCatalog.num_pluralscCr)aWThe 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: `str`Nrr0)rrr)rVexprrrr plural_expr9s zCatalog.plural_exprcCsd|jd|jdS)zReturn 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`z nplurals=z ; plural=;)rrr\rrrrLs zCatalog.plural_formsr@rcCs|||jvS)z?Return whether the catalog has a message with the specified ID._key_forrrVr@rrr __contains__XszCatalog.__contains__cCs t|jS)zeThe number of messages in the catalog. This does not include the special ``msgid ""`` entry.)lenrr\rrr__len__\s zCatalog.__len__Iterator[Message]ccsrg}|jD]\}}||d|qt}|jr |dhO}tdd||dV|jD]}|j|Vq.dS)zIterates through all the entries in the catalog, in the order they were added, yielding a `Message` object for every entry. :rtype: ``iterator``z: r{r?rr|N) mime_headersr"rQr{rrr)rVbufrr*rEkeyrrr__iter__bs  zCatalog.__iter__cCs4d}|jr d|j}dt|jd|j|dS)Nr?rYrX>)rrZr[rrrrrr]qs zCatalog.__repr__cCs||dS)z)Delete the message with the specified ID.N)deleterrrr __delitem__wszCatalog.__delitem__rcCs ||S)zUReturn the message with the specified ID. :param id: the message ID )rrrrr __getitem__{s zCatalog.__getitem__messagecCs"t|ts Jd|||j}|j|}|rS|jr&|js&|j|_|j|_t t |j |j |_ t t |j |j |_ t t |j |j |_ |j|jO_|}dS|dkrqt|j|_ddd|j D|_|j|_dSt|t tfrt|jt tfsJdt|j||j|<dS)aAdd or update the message with the specified ID. >>> 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 zexpected a Message objectr?rcSsg|] }d|qS)z# )rstrip)rcrrrrsz'Catalog.__setitem__..zExpected sequence but got N)rUrrrLrrrOr@rArPrrCrGrHrEritemsrrrr{r}rZ)rVr@rrcurrentrrr __setitem__s6      zCatalog.__setitem__rrBrCrDrErFrGrHrIrJrKrLc Cs*t||t||||||| d } | ||<| S)atAdd 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 )rJrL)rrP) rVr@rArCrErGrHrIrJrLrrrrrSs %z Catalog.add0Iterable[tuple[Message, list[TranslationError]]]ccs0|jD]}|j|d}|r||fVqdS)a\Run 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: ``generator`` of ``(message, errors)`` )rsN)rvaluesrz)rVrrwrrrrzs  z Catalog.checkMessage | NonecCs|j|||S)zReturn the message with the specified ID and context. :param id: the message ID :param context: the message context, or ``None`` for no context )rrr)rVr@rLrrrrsz Catalog.getcCs&|||}||jvr|j|=dSdS)zDelete the message with the specified ID and context. :param id: the message ID :param context: the message context, or ``None`` for no context NrrVr@rLrrrrrs   zCatalog.deleteFtemplateno_fuzzy_matchingupdate_header_commentkeep_user_commentscshjt_g}|s3i}D]}|r2|jr2|}|j}|} ||f|| <qtd fdd } |D]R} | j r| j | j}|vr[| | ||qC|st |t rg|d } n|} t | | d } | r| d } || \}}|d ur||f}| | ||qC| | j <qCD]}|s|vr|j|<q|r|j_|j_d S)aUpdate the catalog based on the given template catalog. >>> 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 rroldkeytuple[str, str] | strnewkeyr,rNcs\|}d}||kr/d}||}|dusJt|jtr(|jg|_nt|j|_n |d}|dus;J|j |_ rItt |j |_ t|jtt frt|j tt fsmd}t |j gdgt |jd|_ n(t |j jkrd}t |j dt |j |_ nt|j tt frd}|j d|_ |j|jO_|r|jdhO_||j<dS)NFTr?r0rr{)rrrSrrUr@r+rIrPpoprArrHr}rrrE)rrrr{ZoldmsgZ fuzzy_matchesrmessages remainingrVrr_mergeIs@        zCatalog.update.._mergerr0N)rrrrrrr,rN)rrrrArrLrstriprQr@rUr}r)keysrrr)rVrrrrZfuzzy_candidatesmsgidrZctxtZ modified_keyrrZmatchkeymatchesrZnewctxtrrrupdatesV;    %        zCatalog.updatercCs.|}t|ttfr |d}|dur||f}|S)zThe key for a message is just the singular ID even for pluralizable messages, but is a ``(msgid, msgctxt)`` tuple for context-specific messages. rN)rUrPr}rrrrrs zCatalog._key_forr^cCspt|tsJ|j|jBD]}||}||}|dus*|dus*||s-dSqt|jt|jkS)z\Checks if catalogs are identical, taking into account messages and headers. NF)rUrrrrrorr)rVr^rZ message_1Z message_2rrrros  zCatalog.is_identical)rrrrMrrMrrMrrMrrMrrMrrrrrrMrrMrrMr{rcr,rN)rrr,rN)r,r)r,rMr)rArMr,rN)r,r)rr)r(rrr+rwr+r,r+)rrr,rN)r,r:)r@rr,rc)r,r)r@rr,rN)r@rr,r)r@rrrr,rN)NrrrrrNN)r@rrArBrCrDrErFrGrFrHrFrIrrJrKrLrMr,r)r,rrp)r@rrLrMr,r)r@rrLrMr,rN)FFT) rrrrcrrcrrcr,rN)r@rrLrMr,r)r^rr,rc)$r[rrrDEFAULT_HEADERrWrrrrrrrrrrrrrrrrrrrr]rrrrSrzrrr rrorrrrrsx F      !   4         4 +      r)rr)r*r+r,r-)r*r+r,r)5r __future__rr.r6 collectionsrcollections.abcrrrdifflibremailrheapqr typingr Zbabelr rZ babel.corer r Z babel.datesrZbabel.messages.pluralsrZ babel.utilrrrrZtyping_extensionsrr+r}rPr__annotations____all__r)compileVERBOSEr~r>r Exceptionrr rrrrrrs>