o
    ADi                     @  st  U d Z ddlmZ ddlZddlZddlmZmZ ddlmZ ddl	m
Z
 ddlmZ ddlmZ dd	lmZ dd
lmZ ddlmZ ddlmZmZ ddlmZ ddlmZ ddlmZmZm Z m!Z! er{ddl"m#Z# e$e%e$df B e&e$ B Z'de(d< g dZ)d6ddZ*e+dej,Z-d7ddZ.d8d"d#Z/G d$d% d%Z0G d&d' d'e1Z2d(Z3d9d*d+Z4d:d;d2d3Z5G d4d5 d5Z6dS )<z
    babel.messages.catalog
    ~~~~~~~~~~~~~~~~~~~~~~

    Data structures for message catalogs.

    :copyright: (c) 2013-2025 by the Babel Team.
    :license: BSD, see LICENSE for more details.
    )annotationsN)IterableIterator)copy)SequenceMatcher)message_from_string)nlargest)	Formatter)TYPE_CHECKING)__version__)LocaleUnknownLocaleError)format_datetime)
get_plural)LOCALTZFixedOffsetTimezone_cmpdistinct)	TypeAlias.r   
_MessageID)DEFAULT_HEADERPYTHON_FORMATCatalogMessageTranslationError   333333?c                 C  s   |dkst d|d|  krdksn t d|g }tdd}||  |D ]"}|| | |krM| |krM| |krM|| |f q+t||}dd	 |D S )
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.
    r   zn must be > 0: g        g      ?zcutoff must be in [0.0, 1.0]: F)autojunkc                 S  s   g | ]\}}|qS  r   ).0scorexr   r   O/var/www/Datamplify/venv/lib/python3.10/site-packages/babel/messages/catalog.py
<listcomp>A   s    z%get_close_matches.<locals>.<listcomp>)	
ValueErrorr   set_seq2set_seq1real_quick_ratioquick_ratioratioappendr   )wordpossibilitiesncutoffresultsr!   r   r   r"   get_close_matches*   s    



r1   z
    \%
        (?:\(([\w]*)\))?
        (
            [-#0\ +]?(?:\*|[\d]+)?
            (?:\.(?:\*|[\d]+))?
            [hlL]?
        )
        ([diouxXeEfFgGcrs%])
stringstrreturnboolc                 C  sR   d| vrdS t  }zd}|| D ]
}|d d urd}qW |S  ty(   Y dS w )N{F   T)r	   parser$   )r2   fmtfield_name_seentr   r   r"   _has_python_brace_formatP   s   r<   valuedatetime.datetimec                 C  s   t d| }tj|dd}|d}|d urV|d |dd  }}|d d |dd  }}t| d}t|}	t|}
|	d	 }||
7 }||9 }t|}|j|d
}|S )Nz+^(?P<datetime>.*?)(?P<tzoffset>[+-]\d{4})?$datetimez%Y-%m-%d %H:%Mtzoffsetr   r7      1<   tzinfo)rematchr?   strptimegroupintr   replace)r=   rG   dtr@   plus_minus_sresthours_offset_smins_offset_s
plus_minushours_offsetmins_offsetnet_mins_offsetr   r   r"   _parse_datetime_headerc   s   
rU   c                   @  s   e Zd ZdZ								d>d?ddZd@ddZdAddZdBd!d"ZdBd#d$ZdBd%d&Z	dBd'd(Z
dBd)d*ZdBd+d,ZdCd-d.ZdDd/d0ZdEdFd4d5ZedGd6d7ZedGd8d9ZedGd:d;ZedGd<d=ZdS )Hr   z0Representation of a single message in a catalog. r   Nidr   r2   _MessageID | None	locationsIterable[tuple[str, int]]flagsIterable[str]auto_commentsuser_commentsprevious_idlineno
int | Nonecontext
str | Noner4   Nonec
           
      C  s   || _ |s
| jr
d}|| _tt|| _t|| _|r%| jr%| j	d n| j
d |r7| jr7| j	d n| j
d tt|| _tt|| _t|trU|g| _nt|| _|| _|	| _dS )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
        )rV   rV   zpython-formatzpython-brace-formatN)rW   pluralizabler2   listr   rY   setr[   python_formatadddiscardpython_brace_formatr]   r^   
isinstancer3   r_   r`   rb   )
selfrW   r2   rY   r[   r]   r^   r_   r`   rb   r   r   r"   __init__   s&   







zMessage.__init__r3   c                 C  s&   dt | j d| jdt| jdS )N< z	 (flags: z)>)type__name__rW   rf   r[   rm   r   r   r"   __repr__   s   &zMessage.__repr__otherobjectrJ   c                 C  s   dd }t || ||S )z0Compare Messages, taking into account plural idsc                 S  s4   t | tr| jr| jd | jpdfS | j| jpdfS )Nr   rV   )rl   r   re   rW   rb   )objr   r   r"   values_to_compare   s   z*Message.__cmp__.<locals>.values_to_compare)r   )rm   ru   rx   r   r   r"   __cmp__   s   zMessage.__cmp__r5   c                 C  s   |  |dkS Nr   ry   rm   ru   r   r   r"   __gt__      zMessage.__gt__c                 C  s   |  |dk S rz   r{   r|   r   r   r"   __lt__   r~   zMessage.__lt__c                 C  s   |  |dkS rz   r{   r|   r   r   r"   __ge__   r~   zMessage.__ge__c                 C  s   |  |dkS rz   r{   r|   r   r   r"   __le__   r~   zMessage.__le__c                 C  s   |  |dkS rz   r{   r|   r   r   r"   __eq__   r~   zMessage.__eq__c                 C  s   |  |dkS rz   r{   r|   r   r   r"   __ne__   r~   zMessage.__ne__c                 C  s   t |tsJ | j|jkS )z[Checks whether messages are identical, taking into account all
        properties.
        )rl   r   __dict__r|   r   r   r"   is_identical   s   zMessage.is_identicalc                 C  s2   t tt| j| j| j| j| j| j| j	| j
| jf	 S N)r   mapr   rW   r2   rY   r[   r]   r^   r_   r`   rb   rs   r   r   r"   clone   s
   zMessage.clonecatalogCatalog | Nonelist[TranslationError]c                 C  sZ   ddl m} g }|D ] }z|||  W q
 ty* } z|| W Y d}~q
d}~ww |S )a  Run 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)babel.messages.checkersr   r   r*   )rm   r   r   errorscheckerer   r   r"   check   s   
zMessage.checkc                 C  s
   d| j v S )a   Whether the translation is fuzzy.

        >>> Message('foo').fuzzy
        False
        >>> msg = Message('foo', 'foo', flags=['fuzzy'])
        >>> msg.fuzzy
        True
        >>> msg
        <Message 'foo' (flags: ['fuzzy'])>

        :type:  `bool`fuzzyr[   rs   r   r   r"   r      s   
zMessage.fuzzyc                 C  s   t | jttfS )zWhether the message is plurizable.

        >>> Message('foo').pluralizable
        False
        >>> Message(('foo', 'bar')).pluralizable
        True

        :type:  `bool`)rl   rW   rf   tuplers   r   r   r"   re     s   
zMessage.pluralizablec                 C  ,   | j }t|ttfs|g}tdd |D S )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`c                 s  s    | ]}t |V  qd S r   )r   searchr   rW   r   r   r"   	<genexpr>  s    z(Message.python_format.<locals>.<genexpr>rW   rl   rf   r   anyrm   idsr   r   r"   rh        
zMessage.python_formatc                 C  r   )zWhether the message contains Python f-string parameters.

        >>> Message('Hello, {name}!').python_brace_format
        True
        >>> Message(('One apple', '{count} apples')).python_brace_format
        True

        :type:  `bool`c                 s  s    | ]}t |V  qd S r   )r<   r   r   r   r"   r   +  s    z.Message.python_brace_format.<locals>.<genexpr>r   r   r   r   r"   rk     r   zMessage.python_brace_format)rV   r   r   r   r   r   NN)rW   r   r2   rX   rY   rZ   r[   r\   r]   r\   r^   r\   r_   r   r`   ra   rb   rc   r4   rd   r4   r3   )ru   rv   r4   rJ   )ru   rv   r4   r5   )ru   r   r4   r5   )r4   r   r   )r   r   r4   r   )r4   r5   )rr   
__module____qualname____doc__rn   rt   ry   r}   r   r   r   r   r   r   r   r   propertyr   re   rh   rk   r   r   r   r"   r      s<    
3








r   c                   @  s   e Zd ZdZdS )r   z_Exception thrown by translation checkers when invalid message
    translations are encountered.N)rr   r   r   r   r   r   r   r"   r   .  s    r   z# Translations template for PROJECT.
# Copyright (C) YEAR ORGANIZATION
# This file is distributed under the same license as the PROJECT project.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#dict[str, str]c                 C  s&   ddl m} | }| |d< t| S )Nr   )r   content-type)email.messager   dict
get_params)r=   r   mr   r   r"   parse_separated_header;  s   r   utf-8strictr0   str | bytesencodingr   c                 C  s,   t | tr| S t | tr| ||S t| S r   )rl   r3   bytesdecode)r0   r   r   r   r   r"   _force_textC  s
   

r   c                   @  s  e Zd ZdZddeddddddddddfdrddZdsddZdtddZdudd Ze	eeZ
e	eZdvd"d#Zdwd%d&Ze	eed'd(Zdxd*d+Zdyd.d/Ze	eed0d(Ze	dzd2d3Ze	dvd4d5Ze	dvd6d7Zd{d:d;Zdzd<d=Zd|d?d@ZdvdAdBZd}dCdDZd~dFdGZddIdJZ		K	K	K	K	K		dddWdXZddZd[Zddd]d^Zddd_d`Z	a	a		dddgdhZ ddkdlZ!dddmdnZ"ddpdqZ#dS )r   z$Representation of a message catalog.NTlocaleLocale | str | Nonedomainrc   header_commentprojectversioncopyright_holdermsgid_bugs_addresscreation_datedatetime.datetime | str | Nonerevision_date6datetime.datetime | datetime.time | float | str | Nonelast_translatorlanguage_teamcharsetr   r5   r4   rd   c                 C  s   || _ || _|| _i | _|pd| _|pd| _|pd| _|pd| _|
p#d| _	 |p)d| _		 |p/d| _
|du r<tjt}nt|tjrK|jsK|jtd	}|| _|	du rUd
}	nt|	tjrd|	jsd|	jtd	}	|	| _|| _i | _d| _d| _dS )aD  Initialize 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
        PROJECTVERSIONORGANIZATIONzEMAIL@ADDRESSzFULL NAME <EMAIL@ADDRESS>zLANGUAGE <LL@li.org>r   NrD   zYEAR-MO-DA HO:MI+ZONE)r   r   _header_comment	_messagesr   r   r   r   r   r   r   r?   nowr   rl   rE   rK   r   r   r   obsolete_num_plurals_plural_expr)rm   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r"   rn   N  s6   $







zCatalog.__init__c                 C  s   |d u rd | _ d | _d S t|trt|| _ || _d S t|tr<t|| _ z	t|| _W d S  ty;   d | _Y d S w td|)NzD`locale` must be a Locale, a locale identifier string, or None; got )_locale_identifier_localerl   r   r3   r8   r   	TypeErrorrm   r   r   r   r"   _set_locale  s$   



zCatalog._set_localeLocale | Nonec                 C     | j S r   )r   rs   r   r   r"   _get_locale     zCatalog._get_localec                 C  r   r   )r   rs   r   r   r"   _get_locale_identifier  r   zCatalog._get_locale_identifierr3   c                 C  s   | j }tjtd}t| jdr| jd}|d| jd| j	d|d| j
}| jr4| jjn| j}|rB|d| d}|S )	Nz%Ystrftimer   r   YEARr   zTranslations templatez translations)r   r?   r   r   r   hasattrr   rK   r   r   r   r   english_namelocale_identifier)rm   commentyearlocale_namer   r   r"   _get_header_comment  s   

zCatalog._get_header_commentr2   c                 C  s
   || _ d S r   )r   )rm   r2   r   r   r"   _set_header_comment  s   
zCatalog._set_header_commenta      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 <EMAIL@ADDRESS>, ....
    #

    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`
    )doclist[tuple[str, str]]c                 C  s  t | jtjtjttfrt| jddd}n| j}| j}| jr+d|v r+|	dt
| j}d| j d| j fd| jfdt| jdddfd	|fd
| jfg}| jrX|dt
| jf |d|f | jd url|d| jf |ddd| j fdddt dfg7 }|S )Nzyyyy-MM-dd HH:mmZen)r   LANGUAGEzProject-Id-Versionrp   zReport-Msgid-Bugs-TozPOT-Creation-DatezPO-Revision-DatezLast-TranslatorLanguagezLanguage-TeamzPlural-Forms)zMIME-Versionz1.0zContent-Typeztext/plain; charset=)zContent-Transfer-Encoding8bitzGenerated-ByzBabel 
)rl   r   r?   timerJ   floatr   r   r   rK   r3   r   r   r   r   r   r*   r   plural_formsr   r   )rm   r   r   headersr   r   r"   _get_mime_headers  s0   
zCatalog._get_mime_headersr   Iterable[tuple[str, str]]c                 C  sF  |D ]\}}t | | jd}t || jd}|dkr/|d}d|d d | _|d | _q|dkr7|| _q|dkr?|| _q|dkrQ|	dd	}| 
|pNd  q|d
krY|| _q|dkrmt|}d|v rl|d  | _q|dkrtd| }t|dd| _|dd| _q|dkrt|| _q|dkrd|vrt|| _qd S )N)r   zproject-id-versionrp   zreport-msgid-bugs-tozlast-translatorlanguage-_zlanguage-teamr   r   zplural-formsz ;npluralsrA   plural(n != 1)zpot-creation-datezpo-revision-dater   )r   lowerr   splitjoinr   r   r   r   rK   r   r   r   rJ   getr   r   rU   r   r   )rm   r   namer=   partsparamsr   r   r"   _set_mime_headers  s@   

zCatalog._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 <EMAIL@ADDRESS>
    Language-Team: LANGUAGE <LL@li.org>
    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 <jd@example.com>',
    ...                   language_team='de_DE <de@example.com>')
    >>> 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 <jd@example.com>
    Language: de_DE
    Language-Team: de_DE <de@example.com>
    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`
    rJ   c                 C  .   | j du rd}| jrt| jd }|| _ | j S )zThe number of plurals used by the catalog or locale.

        >>> Catalog(locale='en').num_plurals
        2
        >>> Catalog(locale='ga').num_plurals
        5

        :type: `int`NrA   r   )r   r   r   )rm   numr   r   r"   num_pluralsZ  s   

zCatalog.num_pluralsc                 C  r   )aW  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: `str`Nr   r7   )r   r   r   )rm   exprr   r   r"   plural_exprk  s   
zCatalog.plural_exprc                 C  s   d| j  d| j dS )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=;)r   r   rs   r   r   r"   r   ~  s   
zCatalog.plural_formsrW   r   c                 C  s   |  || jv S )z?Return whether the catalog has a message with the specified ID._key_forr   rm   rW   r   r   r"   __contains__  s   zCatalog.__contains__c                 C  s
   t | jS )zeThe number of messages in the catalog.

        This does not include the special ``msgid ""`` entry.)lenr   rs   r   r   r"   __len__  s   
zCatalog.__len__Iterator[Message]c                 c  sr    g }| j D ]\}}|| d|  qt }| jr |dhO }tdd||dV  | jD ]}| j| V  q.dS )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   rV   r   r   N)mime_headersr*   rg   r   r   r   r   )rm   bufr   r=   r[   keyr   r   r"   __iter__  s   

zCatalog.__iter__c                 C  s4   d}| j rd| j  }dt| j d| j| dS )NrV   rp   ro   >)r   rq   rr   r   r   r   r   r"   rt     s   zCatalog.__repr__c                 C  s   |  | dS )z)Delete the message with the specified ID.N)deleter  r   r   r"   __delitem__  s   zCatalog.__delitem__r   c                 C  s
   |  |S )zUReturn the message with the specified ID.

        :param id: the message ID
        )r   r  r   r   r"   __getitem__  s   
zCatalog.__getitem__messagec                 C  s  t |ts	J d| ||j}| j|}|rQ|jr&|js&|j|_|j|_t	t
|j|j |_t	t
|j|j |_t	t
|j|j |_| j|jO  _dS |dkrot|j | _ddd |jD | _|j| _dS t |t	tfrt |jt	tfsJ dt|j || j|< dS )a  Add or update the message with the specified ID.

        >>> catalog = Catalog()
        >>> catalog[u'foo'] = Message(u'foo')
        >>> catalog[u'foo']
        <Message u'foo' (flags: [])>

        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
        zexpected a Message objectrV   r   c                 S  s   g | ]	}d |   qS )z# )rstrip)r   cr   r   r"   r#     s    z'Catalog.__setitem__.<locals>.<listcomp>zExpected sequence but got N)rl   r   r   rb   r   r   re   rW   r2   rf   r   rY   r]   r^   r[   r   itemsr  r   r   r   r   rq   )rm   rW   r  r  currentr   r   r"   __setitem__  s4   


zCatalog.__setitem__r   rX   rY   rZ   r[   r\   r]   r^   r_   r`   ra   rb   c
                 C  s*   t ||t|||||||	d	}
|
| |< |
S )at  Add or update the message with the specified ID.

        >>> catalog = Catalog()
        >>> catalog.add(u'foo')
        <Message ...>
        >>> catalog[u'foo']
        <Message u'foo' (flags: [])>

        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`   rb   )r   rf   )rm   rW   r2   rY   r[   r]   r^   r_   r`   rb   r  r   r   r"   ri     s   %zCatalog.add0Iterable[tuple[Message, list[TranslationError]]]c                 c  s0    | j  D ]}|j| d}|r||fV  qdS )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)``
        )r   N)r   valuesr   )rm   r  r   r   r   r"   r     s   	
zCatalog.checkMessage | Nonec                 C  s   | 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
        )r   r   r   )rm   rW   rb   r   r   r"   r     s   zCatalog.getc                 C  s&   |  ||}|| jv r| j|= dS dS )zDelete the message with the specified ID and context.

        :param id: the message ID
        :param context: the message context, or ``None`` for no context
        Nr   rm   rW   rb   r  r   r   r"   r  %  s   
zCatalog.deleteFtemplateno_fuzzy_matchingupdate_header_commentkeep_user_commentsupdate_creation_datec                   sJ  j  i _ i }|s-D ]}|r,| jr,|}| j}	||	f||< qt  d fdd	}
|D ]E}|jr|j|j}|v rU|
||| q=|s}t||	 d
}|r}|d }|| \}}|durv||f}|
||| q=||j< q=D ]}|s| vr| j
|< q|r|j_|r|j_dS dS )a  Update the catalog based on the given template catalog.

        >>> from babel.messages import Catalog
        >>> template = Catalog()
        >>> template.add('green', locations=[('main.py', 99)])
        <Message ...>
        >>> template.add('blue', locations=[('main.py', 100)])
        <Message ...>
        >>> template.add(('salad', 'salads'), locations=[('util.py', 42)])
        <Message ...>
        >>> catalog = Catalog(locale='de_DE')
        >>> catalog.add('blue', u'blau', locations=[('main.py', 98)])
        <Message ...>
        >>> catalog.add('head', u'Kopf', locations=[('util.py', 33)])
        <Message ...>
        >>> catalog.add(('salad', 'salads'), (u'Salat', u'Salate'),
        ...             locations=[('util.py', 38)])
        <Message ...>

        >>> 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())
        [<Message 'head' (flags: [])>]

        :param template: the reference catalog, usually read from a POT file
        :param no_fuzzy_matching: whether to use fuzzy matching of message IDs
        :param update_header_comment: whether to copy the header comment from the template
        :param keep_user_comments: whether to keep user comments from the old catalog
        :param update_creation_date: whether to copy the creation date from the template
        r  r   oldkeytuple[str, str] | strnewkeyr4   rd   c                   s\  |   } d}||kr/d} | |}|d usJ t|jtr(|jg| _nt|j| _n|d }|d us;J |j	| _	rItt
|j| _t| jttfrt| j	ttfsmd}t| j	gdgt| jd   | _	n(t| j	jkrd}t| j	d t|j	 | _	nt| j	ttfrd}| j	d | _	|  j|jO  _|r|  jdhO  _| | j< d S )NFTrV   r7   r   r   )r   ri   r   rl   rW   r3   r_   rf   popr2   r   r^   r   r  r   r[   )r  r  r  r   oldmsgfuzzy_matchesr  messages	remainingrm   r   r"   _merge|  s@   

zCatalog.update.<locals>._merger7   r   N)r  r   r  r  r  r  r4   rd   )r   r   r2   r   rb   _to_fuzzy_match_keyrg   rW   r1   keysr   r   r   )rm   r  r  r  r  r  fuzzy_candidatesmsgidr  ctxtr&  r  matchesmodified_keyr  newctxtr   r"  r"   update/  sT   ?

%
zCatalog.updater  r  c                 C  s$   t |tr
|d }n|}|  S )z?Converts a message key to a string suitable for fuzzy matching.r   )rl   r   r   strip)rm   r  matchkeyr   r   r"   r'    s   

zCatalog._to_fuzzy_match_keyc                 C  s.   |}t |ttfr|d }|dur||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.
        r   N)rl   rf   r   r  r   r   r"   r     s   zCatalog._key_forru   c                 C  sp   t |tsJ | j |j B D ]}| |}||}|du s*|du s*||s- dS qt| jt|jkS )z\Checks if catalogs are identical, taking into account messages and
        headers.
        NF)rl   r   r   r(  r   r   r   r  )rm   ru   r  	message_1	message_2r   r   r"   r     s   

zCatalog.is_identical)r   r   r   rc   r   rc   r   rc   r   rc   r   rc   r   rc   r   r   r   r   r   rc   r   rc   r   rc   r   r5   r4   rd   )r   r   r4   rd   )r4   r   )r4   rc   r   )r2   rc   r4   rd   )r4   r   )r   r   r4   rd   )r4   rJ   )rW   r   r4   r5   )r4   r  )rW   r   r4   rd   )rW   r   r4   r   )rW   r   r  r   r4   rd   )Nr   r   r   r   r   NN)rW   r   r2   rX   rY   rZ   r[   r\   r]   r\   r^   r\   r_   r   r`   ra   rb   rc   r4   r   )r4   r  r   )rW   r   rb   rc   r4   r  )rW   r   rb   rc   r4   rd   )FFTT)r  r   r  r5   r  r5   r  r5   r  r5   r4   rd   )r  r  r4   r3   )rW   r   rb   rc   r4   r  )ru   r   r4   r5   )$rr   r   r   r   r   rn   r   r   r   r   r   r   r   r   r   r   r   r  r   r   r   r  r  r	  rt   r  r  r  ri   r   r   r  r/  r'  r   r   r   r   r   r"   r   K  sz    
F





!
$4






3
+ 
r   )r   r   )r2   r3   r4   r5   )r=   r3   r4   r>   )r=   r3   r4   r   )r   r   )r0   r   r   r3   r   r3   r4   r3   )7r   
__future__r   r?   rF   collections.abcr   r   r   difflibr   emailr   heapqr   r2   r	   typingr
   babelr   r   
babel.corer   r   babel.datesr   babel.messages.pluralsr   
babel.utilr   r   r   r   typing_extensionsr   r3   r   rf   r   __annotations____all__r1   compileVERBOSEr   r<   rU   r   	Exceptionr   r   r   r   r   r   r   r   r"   <module>   sB    	 
		

 .
