
    $gݎ                       U d Z ddlmZ ddlZddl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 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         z  e&e$         z  Z'de(d<   g dZ)d'dZ* ej+        dej,                  Z-d(dZ. G d d          Z/ G d  d!e0          Z1d"Z2d)d$Z3 G d% d&          Z4dS )*z
    babel.messages.catalog
    ~~~~~~~~~~~~~~~~~~~~~~

    Data structures for message catalogs.

    :copyright: (c) 2013-2024 by the Babel Team.
    :license: BSD, see LICENSE for more details.
    )annotationsN)OrderedDict)IterableIterator)copy)SequenceMatcher)message_from_string)nlargest)TYPE_CHECKING)__version__)LocaleUnknownLocaleError)format_datetime)
get_plural)LOCALTZFixedOffsetTimezone_cmpdistinct)	TypeAlias.r   
_MessageID)MessageCatalogTranslationError   333333?c                   |dk    st          d|          d|cxk    rdk    sn t          d|          g }t          d          }|                    |            |D ]}|                    |           |                                |k    rY|                                |k    rA|                                |k    r)|                    |                                |f           t          ||          }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                    g | ]\  }}|S  r   ).0scorexs      V/var/www/html/netbox-4.1.3/venv/lib/python3.11/site-packages/babel/messages/catalog.py
<listcomp>z%get_close_matches.<locals>.<listcomp>:   s    %%%(%A%%%    )	
ValueErrorr   set_seq2set_seq1real_quick_ratioquick_ratioratioappendr
   )wordpossibilitiesncutoffresultsr"   s          r#   get_close_matchesr3   #   s     q550100111&CD&DDEEEF'''AJJt * *	

16))==??f$$7799MM17799a.))) a  F%%f%%%%r%   z
    \%
        (?:\(([\w]*)\))?
        (
            [-#0\ +]?(?:\*|[\d]+)?
            (?:\.(?:\*|[\d]+))?
            [hlL]?
        )
        ([diouxXeEfFgGcrs%])
valuestrreturndatetime.datetimec                   t          j        d|           }t          j                            |                    d          d          }|                    d          }||d         |dd          }}|d d         |dd          }}t          | d          }t          |          }	t          |          }
|	d	z  }||
z  }||z  }t          |          }|                    |
          }|S )Nz+^(?P<datetime>.*?)(?P<tzoffset>[+-]\d{4})?$datetimez%Y-%m-%d %H:%Mtzoffsetr         1<   tzinfo)rematchr9   strptimegroupintr   replace)r4   rB   dtr:   plus_minus_sresthours_offset_smins_offset_s
plus_minushours_offsetmins_offsetnet_mins_offsets               r#   _parse_datetime_headerrP   I   s    HCUKKE			#	#EKK
$;$;=M	N	NB {{:&&H%a[(122,d(,RaR$qrr( L+++,,
>**-(( '+;&:% '77 ZZxZ((Ir%   c                      e Zd ZdZ	 	 	 	 	 	 	 	 d-d.dZd/dZd0dZd1dZd1dZd1d Z	d1d!Z
d1d"Zd1d#Zd2d$Zd3d%Zd4d5d)Zed6d*            Zed6d+            Zed6d,            ZdS )7r   z0Representation of a single message in a catalog. r   Nidr   string_MessageID | None	locationsIterable[tuple[str, int]]flagsIterable[str]auto_commentsuser_commentsprevious_idlineno
int | Nonecontext
str | Noner6   Nonec
                "   || _         |s	| j        rd}|| _        t          t	          |                    | _        t          |          | _        |r"| j        r| j        	                    d           n| j        
                    d           t          t	          |                    | _        t          t	          |                    | _        t          |t                    r	|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
        )rR   rR   zpython-formatN)rS   pluralizablerT   listr   rV   setrX   python_formatadddiscardrZ   r[   
isinstancer5   r\   r]   r_   )
selfrS   rT   rV   rX   rZ   r[   r\   r]   r_   s
             r#   __init__zMessage.__init__j   s    8  	$+ 	Fhy1122ZZ
 	0$$ 	0JNN?++++J///!(="9"9::!(="9"9::k3'' 	1 +}D#K00Dr%   r5   c                l    dt          |           j         d| j        dt          | j                  dS )N< z	 (flags: z)>)type__name__rS   rd   rX   rj   s    r#   __repr__zMessage.__repr__   s8    S4::&SSSST$*=M=MSSSSr%   otherobjectrE   c                L    d }t           ||            ||                    S )z0Compare Messages, taking into account plural idsc                    t          | t                    r| j        r| j        d         | j        pdfS | j        | j        pdfS )Nr   rR   )ri   r   rc   rS   r_   )objs    r#   values_to_comparez*Message.__cmp__.<locals>.values_to_compare   sJ    #w'' 4C,< 4vay#+"33363;,",,r%   )r   )rj   rs   rx   s      r#   __cmp__zMessage.__cmp__   s;    	- 	- 	- %%d++->->u-E-EFFFr%   boolc                4    |                      |          dk    S Nr   ry   rj   rs   s     r#   __gt__zMessage.__gt__       ||E""Q&&r%   c                4    |                      |          dk     S r|   r}   r~   s     r#   __lt__zMessage.__lt__   r   r%   c                4    |                      |          dk    S r|   r}   r~   s     r#   __ge__zMessage.__ge__       ||E""a''r%   c                4    |                      |          dk    S r|   r}   r~   s     r#   __le__zMessage.__le__   r   r%   c                4    |                      |          dk    S r|   r}   r~   s     r#   __eq__zMessage.__eq__   r   r%   c                4    |                      |          dk    S r|   r}   r~   s     r#   __ne__zMessage.__ne__   r   r%   c                P    t          |t                    sJ | j        |j        k    S )z[Checks whether messages are identical, taking into account all
        properties.
        )ri   r   __dict__r~   s     r#   is_identicalzMessage.is_identical   s)     %)))))}..r%   c                    t          t          t          | j        | j        | j        | j        | j        | j        | j	        | j
        | j        f	           S N)r   mapr   rS   rT   rV   rX   rZ   r[   r\   r]   r_   rq   s    r#   clonezMessage.clone   sN    D47DK#':t/A#'#5t7G#';#> ? ? @ 	@r%   catalogCatalog | Nonelist[TranslationError]c                    ddl m} g }|D ];}	  |||            # t          $ r}|                    |           Y d}~4d}~ww xY 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,   )rj   r   r   errorscheckeres         r#   checkzMessage.check   s     	544444)+ 	! 	!G!&&&&# ! ! !a        !s   
A?Ac                    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rX   rq   s    r#   r   zMessage.fuzzy   s     $*$$r%   c                D    t          | j        t          t          f          S )zWhether the message is plurizable.

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

        :type:  `bool`)ri   rS   rd   tuplerq   s    r#   rc   zMessage.pluralizable   s     $'D%=111r%   c                    | j         }t          |t          t          f          s|g}t	          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              3  J   K   | ]}t                               |          V  d S r   )PYTHON_FORMATsearch)r    rS   s     r#   	<genexpr>z(Message.python_format.<locals>.<genexpr>   s0      ::=''++::::::r%   )rS   ri   rd   r   any)rj   idss     r#   rf   zMessage.python_format   sE     g#e}-- 	%C::c::::::r%   )rR   r   r   r   r   r   NN)rS   r   rT   rU   rV   rW   rX   rY   rZ   rY   r[   rY   r\   r   r]   r^   r_   r`   r6   ra   r6   r5   )rs   rt   r6   rE   )rs   rt   r6   rz   )rs   r   r6   rz   )r6   r   r   )r   r   r6   r   )r6   rz   )rp   
__module____qualname____doc__rk   rr   ry   r   r   r   r   r   r   r   r   r   propertyr   rc   rf   r   r%   r#   r   r   g   s       ::
 %'/1!')')"$!"- - - - -^T T T TG G G G' ' ' '' ' ' '( ( ( (( ( ( (( ( ( (( ( ( (/ / / /@ @ @ @    & % % % X% 	2 	2 	2 X	2 ; ; ; X; ; ;r%   r   c                      e Zd ZdZdS )r   z_Exception thrown by translation checkers when invalid message
    translations are encountered.N)rp   r   r   r   r   r%   r#   r   r     s        % % % %r%   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                n    ddl m}  |            }| |d<   t          |                                          S )Nr   )r   content-type)email.messager   dict
get_params)r4   r   ms      r#   parse_separated_headerr     s?    %%%%%%		AAnr%   c                     e Zd ZdZddeddddddddddfd`dZdadZdbdZdcdZ e	ee          Z
 e	e          ZdddZded!Z e	eed"#          Zdfd%Zdgdhd,Zdid/Z e	eed0#          Ze	djd2            Ze	ddd3            Ze	ddd4            Zdkd7Zdjd8Zdld:Zddd;Zdmd<Zdnd>Zdod@Z	 	 	 	 	 	 	 	 dpdqdMZdrdOZdsdtdQZdsdudRZ 	 	 	 	 dvdwdYZ!dxd\Z"dsdyd]Z#dzd_Z$dS ){r   z$Representation of a message catalog.NTlocalestr | Locale | Nonedomainr`   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   rz   r6   ra   c                   || _         || _        || _        t                      | _        |pd| _        |pd| _        |pd| _        |pd| _        |
pd| _	        	 |pd| _
        	 |pd| _        |%t          j                            t                    }n<t          |t          j                  r"|j        s|                    t          	          }|| _        |	d
}	n<t          |	t          j                  r"|	j        s|	                    t          	          }	|	| _        || _        t                      | _        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>utf-8Nr?   zYEAR-MO-DA HO:MI+ZONE)r   r   _header_commentr   	_messagesr   r   r   r   r   r   r   r9   nowr   ri   r@   rF   r   r   r   obsolete_num_plurals_plural_expr)rj   r   r   r   r   r   r   r   r   r   r   r   r   r   s                 r#   rk   zCatalog.__init__  s[   H -FQmm+)+) 0 BN"4"G.M2M<*D.D:)' $-11'::MMx'899 	B-BV 	B)111AAM* 3MMx'899 	B-BV 	B)111AAM*
 FQ]]  r%   Locale | str | Nonec                h   |d | _         d | _        d S t          |t                    rt	          |          | _         || _        d S t          |t                    rHt	          |          | _         	 t          j        |          | _        n# t          $ r
 d | _        Y nw xY wd S t          d|          )NzD`locale` must be a Locale, a locale identifier string, or None; got )_locale_identifier_localeri   r   r5   parser   	TypeErrorrj   r   s     r#   _set_localezCatalog._set_locale_  s    >&*D#DLFff%% 	&)&kkD#!DLFfc"" 	&)&kkD#$%|F33% $ $ $#$Fi_eiijjjs   /B	 	BBLocale | Nonec                    | j         S r   )r   rq   s    r#   _get_localezCatalog._get_localet  s
    |r%   c                    | j         S r   )r   rq   s    r#   _get_locale_identifierzCatalog._get_locale_identifierw  s    &&r%   r5   c                   | j         }t          j                            t                                        d          }t          | j        d          r| j                            d          }|                    d| j                                      d| j	                                      d|                              d| j
                  }| j        r| j        j        n| j        }|r|                    d| d          }|S )	Nz%Ystrftimer   r   YEARr   zTranslations templatez translations)r   r9   r   r   r   hasattrr   rF   r   r   r   r   english_namelocale_identifier)rj   commentyearlocale_names       r#   _get_header_commentzCatalog._get_header_comment}  s    & $$W--66t<<4%z22 	5%..t44D//)T\::!')T\::!'&$//!'.$2GHH 	 48;Zt{//DDZ 	^oo&=+?\?\?\]]Gr%   rT   c                    || _         d S r   )r   )rj   rT   s     r#   _set_header_commentzCatalog._set_header_comment  s    %r%   a      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           	     t   g }|                     d| j         d| j         f           |                     d| j        f           |                     dt	          | j        dd          f           t          | j        t          j        t          j	        t          t          f          r-|                     dt	          | j        dd          f           n|                     d| j        f           |                     d	| j        f           | j        r)|                     d
t          | j                  f           | j        rLd| j        v rC|                     d| j                            dt          | j                            f           n|                     d| j        f           | j        |                     d| j        f           |                     d           |                     dd| j         f           |                     d           |                     ddt(           df           |S )NzProject-Id-Versionrn   zReport-Msgid-Bugs-TozPOT-Creation-Datezyyyy-MM-dd HH:mmZen)r   zPO-Revision-DatezLast-TranslatorLanguageLANGUAGEzLanguage-TeamzPlural-Forms)zMIME-Versionz1.0zContent-Typeztext/plain; charset=)zContent-Transfer-Encoding8bitzGenerated-ByzBabel 
)r,   r   r   r   r   r   ri   r   r9   timerE   floatr   r   r5   r   rF   r   plural_formsr   r   )rj   headerss     r#   _get_mime_headerszCatalog._get_mime_headers  sq   )+,.N.N.N.NOPPP.0GHIII+'(:<O/35 5 56 	7 	7 	7 d(8+<hmSRW*XYY 	ENN.+D,>,?N N NO P P P P NN.0BCDDD)4+?@AAA! 	FNNJD,B(C(CDEEE! 	BzT5G'G'GNNO .66z7:4;Q7R7RT TU V V V V NNOT-?@AAA;"NNND,=>???.///(Mt|(M(MNOOO<===(<(<(<(<=>>>r%   r   strictr2   str | bytesencodingr   c                    t          |t                    r|S t          |t                    r|                    ||          S t          |          S r   )ri   r5   bytesdecode)rj   r2   r   r   s       r#   _force_textzCatalog._force_text  sJ    a 	Ha 	.88Hf---1vvr%   r   Iterable[tuple[str, str]]c                   |D ]\  }}|                      |                                | j                  }|                      || j                  }|dk    rE|                    d          }d                    |d d                   | _        |d         | _        |dk    r|| _        |dk    r|| _        |dk    r.|	                    dd	          }| 
                    |pd            |d
k    r|| _        |dk    r4t          |          }d|v r|d                                         | _        3|dk    rWt          d|           }t          |                    dd                    | _        |                    dd          | _        |dk    rt#          |          | _        |dk    rd|vrt#          |          | _        d S )N)r   zproject-id-versionrn   zreport-msgid-bugs-tozlast-translatorlanguage-_zlanguage-teamr   r   zplural-formsz ;npluralsr<   plural(n != 1)zpot-creation-datezpo-revision-dater   )r   lowerr   splitjoinr   r   r   r   rF   r   r   r   rE   getr   r   rP   r   r   )rj   r   namer4   partsparamss         r#   _set_mime_headerszCatalog._set_mime_headers  s   " !	G !	GKD%##DJJLL4<#HHD$$UT\$BBE+++C(("xxcrc
33$Ry///*/''***',$$##c3//
   $////((%*""''/66&&#))#4#:#:#<#<DL''/U==$'

:q(A(A$B$B!$*JJx$D$D!!,,,%;E%B%B""+++&&)?)F)FD&C!	G !	Gr%   a      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`
    rE   c                r    | j         *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`Nr<   r   )r   r   r   )rj   nums     r#   num_pluralszCatalog.num_plurals,  sA     $C{ 1 --a0 #D  r%   c                r    | j         *d}| j        rt          | j                  d         }|| _         | j         S )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  r;   )r   r   r   )rj   exprs     r#   plural_exprzCatalog.plural_expr=  sA     $D{ 2!$+..q1 $D  r%   c                (    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  rq   s    r#   r   zCatalog.plural_formsP  s$     J4+IId6FIIIIr%   rS   r   c                :    |                      |          | j        v S )z?Return whether the catalog has a message with the specified ID._key_forr   rj   rS   s     r#   __contains__zCatalog.__contains__\  s    }}R  DN22r%   c                *    t          | j                  S )zeThe number of messages in the catalog.

        This does not include the special ``msgid ""`` entry.)lenr   rq   s    r#   __len__zCatalog.__len__`  s     4>"""r%   Iterator[Message]c              #    K   g }| j         D ]\  }}|                    | d|             t                      }| j        r|dhz  }t	          dd                    |          |          V  | j        D ]}| j        |         V  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   rR   r   r   N)mime_headersr,   re   r   r   r
  r   )rj   bufr  r4   rX   keys         r#   __iter__zCatalog.__iter__f  s      
 , 	+ 	+KD%JJ$))%))****: 	gYEb$))C..666666> 	& 	&C.%%%%%	& 	&r%   c                l    d}| j         r
d| j          }dt          |           j         d| j        | dS )NrR   rn   rm   >)r   ro   rp   r   r   s     r#   rr   zCatalog.__repr__u  sI    ; 	'&&&FA4::&AAAAAAAr%   c                0    |                      |           dS )z)Delete the message with the specified ID.N)deleter  s     r#   __delitem__zCatalog.__delitem__{  s    Br%   r   c                ,    |                      |          S )zUReturn the message with the specified ID.

        :param id: the message ID
        )r  r  s     r#   __getitem__zCatalog.__getitem__  s    
 xx||r%   messagec                   t          |t                    s
J d            |                     ||j                  }| j                            |          }|r|j        r|j        s|j        |_        |j        |_        t          t          |j        |j        z                       |_        t          t          |j        |j        z                       |_        t          t          |j        |j        z                       |_        |xj        |j        z  c_        |}dS |dk    rbt          |j                                                  | _        d                    d |j        D                       | _        |j        | _        dS t          |t          t*          f          r@t          |j        t          t*          f          sJ 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 objectrR   r   c                <    g | ]}d |                                  S )z# )rstrip)r    cs     r#   r$   z'Catalog.__setitem__.<locals>.<listcomp>  s(    ,^,^,^1X!XX__->->,^,^,^r%   zExpected sequence but got N)ri   r   r  r_   r   r  rc   rS   rT   rd   r   rV   rZ   r[   rX   r	   itemsr"  r
  r   r   r   ro   )rj   rS   r-  r$  currents        r#   __setitem__zCatalog.__setitem__  s   , '7++HH-HHHHmmB00.$$S)) 	*# 0G,@ 0$Z
!( $Xg.?.5.?/@ &A &A !B !BG$('2G292G3H *I *I %J %JG!$('2G292G3H *I *I %J %JG!MMW]*MMGGG2XX 3GN C C I I K KD"&)),^,^H],^,^,^"_"_D DJJJ"tUm,, H!'.4-@@ H HGgn1E1EGGH H H")DN3r%   r   rU   rV   rW   rX   rY   rZ   r[   r\   r]   r^   r_   c
                Z    t          ||t          |          ||||||		  	        }
|
| |<   |
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]   r_   )r   rd   )rj   rS   rT   rV   rX   rZ   r[   r\   r]   r_   r-  s              r#   rg   zCatalog.add  sC    J "fd9ooum'V")+ + + Rr%   0Iterable[tuple[Message, list[TranslationError]]]c              #  ~   K   | j                                         D ] }|                    |           }|r||fV  !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   )rj   r-  r   s      r#   r   zCatalog.check  s[       ~,,.. 	& 	&G]]4]00F &vo%%%	& 	&r%   Message | Nonec                ^    | 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  )rj   rS   r_   s      r#   r  zCatalog.get  s(     ~!!$--G"<"<===r%   c                X    |                      ||          }|| 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  rj   rS   r_   r$  s       r#   r)  zCatalog.delete  s<     mmB(($.  s### ! r%   Ftemplateno_fuzzy_matchingupdate_header_commentkeep_user_commentsupdate_creation_datec                     j                                         t                       _         i }|sPD ]M}|rI|         j        r<                     |          }|         j        }	||	f|                     |          <   Nt                      d fd}
|D ]}|j        r                     |j        |j                  }|v r |
|||           ;|s_t                               |          |
                                d	          }|r'|d
         }||         \  }}|||f} |
|||           | |j        <   D ]}|s|vr|          j        |<   |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
        r-  r   oldkeytuple[str, str] | strnewkeyr6   ra   c                *   |                                  } d}||k    rrd}                    |                               |          }|J t          |j        t
                    r|j        g| _        n4t          |j                  | _        n                    |d           }|J |j	        | _	        r&t          t          |j                            | _        t          | j        t          t          f          rt          | j	        t          t          f          s9d}t          | j	        gdgt          | j                  dz
  z  z             | _	        nt          | j	                  	j        k    r5d}t          | j	        d t          |j	                                     | _	        n5t          | j	        t          t          f          rd}| j	        d         | _	        | xj        |j        z  c_        |r| xj        dhz  c_        | 	| j        <   d S )NFTrR   r;   r   r   )r   rg   r  ri   rS   r5   r\   rd   poprT   r   r[   r   r  r  rX   )
r-  rC  rE  r   oldmsgfuzzy_matchesr@  messages	remainingrj   s
        r#   _mergezCatalog.update.<locals>._mergeL  s   mmooGE!!&)))!f--)))fi-- :+19+G''*.vy//G''"vt44)))#]GN! M(,Xf6J-K-K(L(L%'*tUm44 3!'.4-@@ P E%* (RDC
OOa4G,HI& &GNN ((D,<<< E%*7>:M3v};M;M:M+N%O%OGNGNT5M:: 3!(!2MMV\)MM +'*&Dr%   r;   r   N)r-  r   rC  rD  rE  rD  r6   ra   )r   r   r   rT   r  r_   _to_fuzzy_match_keyre   rS   r3   keysr   r   r   )rj   r=  r>  r?  r@  rA  fuzzy_candidatesmsgidr$  ctxtrL  r-  matchesmodified_keyrE  newctxtrI  rJ  rK  s   `   `           @@@r#   updatezCatalog.update  s'   x >MMOO	$   	R! R R RXe_3 R--..C#E?2DGJDk$T%=%=c%B%BC#	' #	' #	' #	' #	' #	' #	' #	' #	' #	'J   	/ 	/Gz /mmGJ@@(??F7C----, %"3 44S99,1133# #
 # %+21:L.>|.LOFG&2)/"F7FC888$'.D$ 	8 	8E  8E$>$>'0'7e$  	: #+"9D   	8!)!7D	8 	8r%   r$  rD  c                    t          |t                    r	|d         }n|}|                                                                S )z?Converts a message key to a string suitable for fuzzy matching.r   )ri   r   r  strip)rj   r$  matchkeys      r#   rM  zCatalog._to_fuzzy_match_key  s@    c5!! 	1vHHH~~%%'''r%   c                ^    |}t          |t          t          f          r|d         }|||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   )ri   rd   r   r<  s       r#   r  zCatalog._key_for  s<    
 cD%=)) 	Q%C.C
r%   rs   c                |   t          |t                    sJ | j                                        |j                                        z  D ]H}|                     |          }|                    |          }|||                    |          s dS It          | j                  t          |j                  k    S )z\Checks if catalogs are identical, taking into account messages and
        headers.
        NF)ri   r   r   rN  r  r   r   r"  )rj   rs   r$  	message_1	message_2s        r#   r   zCatalog.is_identical  s     %)))))>&&((5?+?+?+A+AA 	 	CI		#I!$ --i88 % uu % D%&&$u/A*B*BBBr%   )r   r   r   r`   r   r`   r   r`   r   r`   r   r`   r   r`   r   r   r   r   r   r`   r   r`   r   r`   r   rz   r6   ra   )r   r   r6   ra   )r6   r   )r6   r`   r   )rT   r`   r6   ra   )r6   r   )r   r   )r2   r   r   r5   r   r5   r6   r5   )r   r   r6   ra   )r6   rE   )rS   r   r6   rz   )r6   r   )rS   r   r6   ra   )rS   r   r6   r   )rS   r   r-  r   r6   ra   )Nr   r   r   r   r   NN)rS   r   rT   rU   rV   rW   rX   rY   rZ   rY   r[   rY   r\   r   r]   r^   r_   r`   r6   r   )r6   r6  r   )rS   r   r_   r`   r6   r9  )rS   r   r_   r`   r6   ra   )FFTT)r=  r   r>  rz   r?  rz   r@  rz   rA  rz   r6   ra   )r$  rD  r6   r5   )rS   r   r_   r`   r6   rD  )rs   r   r6   rz   )%rp   r   r   r   DEFAULT_HEADERrk   r   r   r   r   r   r   r   r   r   r   r   r  r"  r  r  r   r  r  r%  rr   r*  r,  r4  rg   r   r  r)  rU  rM  r  r   r   r%   r#   r   r     sa       .. '+!%3""'+)-8<PT&*$("D! D! D! D! D!Lk k k k*   ' ' ' ' Xk;//F !788   & & & & X13F M 	 	 	NB   <    "G "G "G "GH 8-/@ 2G 2	 2	 2	Lh ! ! ! X!  ! ! ! X!$ 	J 	J 	J X	J3 3 3 3# # # #& & & &B B B B      /* /* /* /*h %)/1!')')"$!") ) ) ) )V& & & &> > > > >$ $ $ $ $ #(&+#'%)R8 R8 R8 R8 R8h( ( ( (
 
 
 
 
C C C C C Cr%   r   )r   r   )r4   r5   r6   r7   )r4   r5   r6   r   )5r   
__future__r   r9   rA   collectionsr   collections.abcr   r   r   difflibr   emailr	   heapqr
   typingr   babelr   r   
babel.corer   r   babel.datesr   babel.messages.pluralsr   
babel.utilr   r   r   r   typing_extensionsr   r5   r   rd   r   __annotations____all__r3   compileVERBOSEr   rP   r   	Exceptionr   r]  r   r   r   r%   r#   <module>rp     s     # " " " " "  				 # # # # # # . . . . . . . .       # # # # # # % % % % % %                   ( ( ( ( ( ( 1 1 1 1 1 1 1 1 ' ' ' ' ' ' - - - - - - C C C C C C C C C C C C >++++++%S/1DI=J====
4
4
4& & & &4 
 	 Z	 	   <W; W; W; W; W; W; W; W;t% % % % %y % % %
       b
C b
C b
C b
C b
C b
C b
C b
C b
C b
Cr%   