HOME

Mini Shell 1.0
DIR:/lib/python2.7/site-packages/babel/messages/
Current File : //lib/python2.7/site-packages/babel/messages/catalog.pyc
�
��Mc@sLdZddlmZddlmZddlmZddlmZddlmZddl	Z	ddl
Z
ddlmZ
dd	lmZdd
lmZddlmZddlmZmZmZmZmZmZd
ddgZdZe	jd�Zd
efd��YZ de!fd��YZ"dZ#defd��YZ$dS(s%Data structures for message catalogs.i����(tparse_header(tdatetime(tget_close_matches(tmessage_from_string(tcopyN(t__version__(tLocale(tformat_datetime(t
get_plural(todicttdistincttsettLOCALTZtUTCtFixedOffsetTimezonetMessagetCatalogtTranslationErrorsrestructuredtext ens�(?x)
    \%
        (?:\(([\w]*)\))?
        (
            [-#0\ +]?(?:\*|[\d]+)?
            (?:\.(?:\*|[\d]+))?
            [hlL]?
        )
        ([diouxXeEfFgGcrs%])
cBs�eZdZdddddddd�Zd�Zd�Zd�Zdd�Zd�Z	e
e	dd	�Z	d
�Ze
edd�Zd�Ze
edd
�ZRS(s0Representation of a single message in a catalog.uc		Cs�||_|r"|jr"d}n||_tt|��|_t|�|_|rq|jrq|jj	d�n|jj
d�tt|��|_tt|��|_t
|t�r�|g|_nt|�|_||_dS(s4Create 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 ``(filenname, 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
        us
python-formatN(uu(tidtpluralizabletstringtlistR
t	locationsRtflagst
python_formattaddtdiscardt
auto_commentst
user_commentst
isinstancet
basestringtprevious_idtlineno(	tselfRRRRRRRR ((s:/usr/lib/python2.7/site-packages/babel/messages/catalog.pyt__init__1s			cCs&dt|�j|jt|j�fS(Ns<%s %r (flags: %r)>(ttypet__name__RRR(R!((s:/usr/lib/python2.7/site-packages/babel/messages/catalog.pyt__repr__TscCs�t|t�r�|j}|j}|rH|rHt|jd|jd�S|ret|jd|j�S|r�t|j|jd�Snt|j|j�S(s0Compare Messages, taking into account plural idsi(RRRtcmpR(R!tobjtpluralt
obj_plural((s:/usr/lib/python2.7/site-packages/babel/messages/catalog.pyt__cmp__Xs		cCsCttt|j|j|j|j|j|j|j	|j
f��S(N(RtmapRRRRRRRRR (R!((s:/usr/lib/python2.7/site-packages/babel/messages/catalog.pytcloneescCs_ddlm}g}xB|D]:}y|||�Wqtk
rV}|j|�qXqW|S(s�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.
        i����(tcheckers(tbabel.messages.checkersR-Rtappend(R!tcatalogR-terrorstcheckerte((s:/usr/lib/python2.7/site-packages/babel/messages/catalog.pytcheckks

cCs
d|jkS(Ntfuzzy(R(R!((s:/usr/lib/python2.7/site-packages/babel/messages/catalog.pyR5~stdocs        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`
        cCst|jttf�S(N(RRRttuple(R!((s:/usr/lib/python2.7/site-packages/babel/messages/catalog.pyR�ss�        Whether the message is plurizable.

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

        :type:  `bool`
        cCsY|j}t|ttf�s*|g}nttdg|D]}tj|�^q:��S(N(	RRRR7tbooltfiltertNonet
PYTHON_FORMATtsearch(R!tidsR((s:/usr/lib/python2.7/site-packages/babel/messages/catalog.pyR�s	s�        Whether 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`
        (((((N(
R$t
__module__t__doc__R:R"R%R*R,R4R5tpropertyRR(((s:/usr/lib/python2.7/site-packages/babel/messages/catalog.pyR.s "		
											cBseZdZRS(s_Exception thrown by translation checkers when invalid message
    translations are encountered.(R$R>R?(((s:/usr/lib/python2.7/site-packages/babel/messages/catalog.pyR�su�# 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.
#cBsXeZdZddeddddddddded�
Zd�Zd�Ze	eedd�Z
d�Zd�Ze	eedd	�Z
d
�Ze	edd�Zd�Ze	edd
�Zd�Ze	edd�Zd�Zd�Zd�Zd�Zd�Zd�Zd�Zdddddd dd�Zd�Zed�Zd�ZRS(!s$Representation of a message catalog.sutf-8cCs}||_|r!tj|�}n||_||_t�|_|pHd|_|pWd|_|pfd|_	|pud|_
|
p�d|_|p�d|_|p�d|_
|d	kr�tjt�}n.t|t�r�|jr�|jdt�}n||_|	d	krtjt�}	n.t|	t�rI|	jrI|	jdt�}	n|	|_|
|_t�|_d	|_d	|_d	S(
s0Initialize 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
        :param fuzzy: the fuzzy bit on the catalog header
        tPROJECTtVERSIONtORGANIZATIONs
EMAIL@ADDRESSsFULL NAME <EMAIL@ADDRESS>sLANGUAGE <LL@li.org>sutf-8ttzinfoN(tdomainRtparsetlocalet_header_commentR	t	_messagestprojecttversiontcopyright_holdertmsgid_bugs_addresstlast_translatort
language_teamtcharsetR:RtnowRRRDtreplacet
creation_datet
revision_dateR5tobsoletet_num_pluralst_plural_expr(R!RGREtheader_commentRJRKRLRMRSRTRNRORPR5((s:/usr/lib/python2.7/site-packages/babel/messages/catalog.pyR"�s6							cCs�|j}|jd|j�jd|j�jd|jjd��jd|j�}|jr||jdd|jj�}n|S(NRARBtYEARs%YRCsTranslations templates%s translations(	RHRRRJRKRTtstrftimeRLRGtenglish_name(R!tcomment((s:/usr/lib/python2.7/site-packages/babel/messages/catalog.pyt_get_header_comment�s		cCs
||_dS(N(RH(R!R((s:/usr/lib/python2.7/site-packages/babel/messages/catalog.pyt_set_header_commentsR6s�    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`
    cCshg}|jdd|j|jff�|jd|jf�|jdt|jddd�f�|jdkr�|jd�|jd�|jd�n||jdt|jddd�f�|jd
|j	f�|jd|j
jdt|j��f�|jd|j
f�|jd�|jdd|jf�|jd�|jddtf�|S(NsProject-Id-Versions%s %ssReport-Msgid-Bugs-TosPOT-Creation-Datesyyyy-MM-dd HH:mmZRGtensPO-Revision-DatesYEAR-MO-DA HO:MI+ZONEsLast-TranslatorsFULL NAME <EMAIL@ADDRESS>s
Language-TeamsLANGUAGE <LL@li.org>tLANGUAGEsPlural-FormssMIME-Versions1.0sContent-Typestext/plain; charset=%ssContent-Transfer-Encodingt8bitsGenerated-Bys	Babel %s
(sPO-Revision-DatesYEAR-MO-DA HO:MI+ZONE(sLast-TranslatorsFULL NAME <EMAIL@ADDRESS>(s
Language-TeamsLANGUAGE <LL@li.org>(sMIME-Versions1.0(sContent-Transfer-EncodingRa(R/RJRKRMRRSRGR:RTRNRORRtstrtplural_formsRPRB(R!theaders((s:/usr/lib/python2.7/site-packages/babel/messages/catalog.pyt_get_mime_headers's2		


			
	
cCsox^|D]V\}}|j�dkrt|�\}}d|krY|dj�|_nPqqWx|D]�\}}|j�j|j�}|j|j�}|dkr�|jd�}dj|d �|_|d|_qh|dkr�||_qh|dkr||_	qh|d	kr'||_
qh|d
kr|td|�\}}t|jdd
��|_
|jdd�|_qh|dkrjtjd|d�\}}}tj|d�}	tj|	�}
|d|d}}|d
 |d
}
}t|d�}t|
�}t|�}|d}||7}||9}t|�}tj|
�}|jd|�|_qh|dkrhd|krgtjd|d�\}}}tj|d�}	tj|	�}
|d|d}}|d
 |d
}
}t|d�}t|
�}t|�}|d}||7}||9}t|�}tj|
�}|jd|�|_qgqhqhWdS(Nscontent-typeRPsproject-id-versiont u i����sreport-msgid-bugs-toslast-translators
language-teamsplural-formss ;tnpluralsiR(s(n != 1)spot-creation-dates([+-]\d{4})$is%Y-%m-%d %H:%Mit1i<RDspo-revision-dateRY(tlowerRRPtdecodetsplittjoinRJRKRMRNROtinttgetRVRWtrettimetstrptimetmktimeRRt
fromtimestampRRRSRT(R!Rdtnametvaluetmimetypetparamstpartst_ttzoffsettttttstplus_minus_strestthours_offset_st
mins_offset_st
plus_minusthours_offsettmins_offsettnet_mins_offsettdt((s:/usr/lib/python2.7/site-packages/babel/messages/catalog.pyt_set_mime_headersCsl





s�    The MIME headers of the catalog, used for the special ``msgid ""`` entry.

    The behavior of this property changes slightly depending on whether a locale
    is set or not, the latter indicating that the catalog is actually a template
    for actual translations.

    Here's an example of the output for such a catalog template:

    >>> 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-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`
    cCsG|jdkr@d}|jr4t|j�d}n||_n|jS(Nii(RVR:RGR(R!tnum((s:/usr/lib/python2.7/site-packages/babel/messages/catalog.pytnum_plurals�s	s�    The number of plurals used by the catalog or locale.

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

    :type: `int`
    cCsG|jdkr@d}|jr4t|j�d}n||_n|jS(Ns(n != 1)i(RWR:RGR(R!texpr((s:/usr/lib/python2.7/site-packages/babel/messages/catalog.pytplural_expr�s	s�    The plural expression used by the catalog or locale.

    >>> Catalog(locale='en').plural_expr
    '(n != 1)'
    >>> Catalog(locale='ga').plural_expr
    '(n==1 ? 0 : n==2 ? 1 : 2)'

    :type: `basestring`
    cCsd|j|jfS(Nsnplurals=%s; plural=%s(R�R�(R!((s:/usr/lib/python2.7/site-packages/babel/messages/catalog.pyRc�ss�    Return 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`
    cCs|j|�|jkS(s?Return whether the catalog has a message with the specified ID.(t_key_forRI(R!R((s:/usr/lib/python2.7/site-packages/babel/messages/catalog.pyt__contains__�scCs
t|j�S(snThe number of messages in the catalog.

        This does not include the special ``msgid ""`` entry.
        (tlenRI(R!((s:/usr/lib/python2.7/site-packages/babel/messages/catalog.pyt__len__�sccs�g}x.|jD]#\}}|jd||f�qWt�}|jr_|tdg�O}ntddj|�d|�Vx|jD]}|j|Vq�WdS(s�Iterates through all the entries in the catalog, in the order they
        were added, yielding a `Message` object for every entry.

        :rtype: ``iterator``
        s%s: %sR5us
RN(tmime_headersR/RR5RRlRI(R!tbufRtRuRtkey((s:/usr/lib/python2.7/site-packages/babel/messages/catalog.pyt__iter__s		cCs<d}|jrd|j}ndt|�j|j|fS(Nts %ss	<%s %r%s>(RGR#R$RE(R!RG((s:/usr/lib/python2.7/site-packages/babel/messages/catalog.pyR%s	cCs/|j|�}||jkr+|j|=ndS(s)Delete the message with the specified ID.N(R�RI(R!RR�((s:/usr/lib/python2.7/site-packages/babel/messages/catalog.pyt__delitem__scCs|jj|j|��S(s�Return the message with the specified ID.

        :param id: the message ID
        :return: the message with the specified ID, or `None` if no such message
                 is in the catalog
        :rtype: `Message`
        (RIRnR�(R!R((s:/usr/lib/python2.7/site-packages/babel/messages/catalog.pyt__getitem__scCs�t|t�std��|j|�}|jj|�}|r�|jrp|jrp|j|_|j|_nt	t
|j|j��|_t	t
|j|j��|_t	t
|j
|j
��|_
|j|jO_|}n�|dkrYt|jj|j��}|j�|_djg|j
D]}d|^q.�|_|j|_nVt|t	tf�r�t|jt	tf�s�tdt|j���n||j|<dS(s�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
        sexpected a Message objectR�s
s# %ssExpected sequence but got %sN(RRtAssertionErrorR�RIRnRRRRR
RRRRRtencodeRPtitemsR�RlRXR5R7R#(R!RtmessageR�tcurrentRdR\((s:/usr/lib/python2.7/site-packages/babel/messages/catalog.pyt__setitem__)s2		#c		
Cs2t||t|�||||d|�||<dS(s3Add or update the message with the specified ID.

        >>> catalog = Catalog()
        >>> catalog.add(u'foo')
        >>> 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 ``(filenname, 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
        R N(RR(	R!RRRRRRRR ((s:/usr/lib/python2.7/site-packages/babel/messages/catalog.pyR\sccsDx=|jj�D],}|jd|�}|r||fVqqWdS(sBRun various validation checks on the translations in the catalog.

        For every message which fails validation, this method yield a
        ``(message, errors)`` tuple, where ``message`` is the `Message` object
        and ``errors`` is a sequence of `TranslationError` objects.

        :rtype: ``iterator``
        R0N(RItvaluesR4(R!R�R1((s:/usr/lib/python2.7/site-packages/babel/messages/catalog.pyR4xs	c	s��j��j��t��_g}|seg�D](}|r4�|jr4�j|�^q4}nt������fd�}x�|D]�}|jr��j|j�}|�kr�||||�q*|tkrt|j	�j
�|d�}|r|||d|�q�qn|�|j<q�q�Wt��_x4�D],}|sY|�krA�|�j|<qAqAW|j�_dS(sUpdate 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
        >>> 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
        cs�|j�}t}||kryt}�j|��j|�}t|jt�rd|jg|_q�t	|j�|_n�j
|d�}|j|_t|jt	t
f�r@t|jt	t
f�s�t}t
|jgdgt|j�d�|_qqt|j��jkrqt}t
|jt|j� �|_qqn1t|jt	t
f�rqt}|jd|_n|j|jO_|r�|jtdg�O_n|�|j<dS(Nuiiufuzzy(R,tFalsetTrueRRnRRRRRtpopR:RR7R�R�RR(R�toldkeytnewkeyR5toldmsg(t
fuzzy_matchestmessagest	remainingR!(s:/usr/lib/python2.7/site-packages/babel/messages/catalog.pyt_merge�s4
-%iiN(
RIRR	RR�RRR�RRitstripRURS(	R!ttemplatetno_fuzzy_matchingtfuzzy_candidatestmsgidR�R�R�tmatches((R�R�R�R!s:/usr/lib/python2.7/site-packages/babel/messages/catalog.pytupdate�s4/	
+	
		
cCs,|}t|ttf�r(|d}n|S(s^The key for a message is just the singular ID even for pluralizable
        messages.
        i(RRR7(R!RR�((s:/usr/lib/python2.7/site-packages/babel/messages/catalog.pyR��s
N((((((R$R>R?R:tDEFAULT_HEADERR�R"R]R^R@RXReR�R�R�R�RcR�R�R�R%R�R�R�RR4R�R�R�(((s:/usr/lib/python2.7/site-packages/babel/messages/catalog.pyR�sF			8					S/																			
	3	s(%R?tcgiRRtdifflibRtemailRRRoRptbabelRRBt
babel.coreRtbabel.datesRtbabel.messages.pluralsRt
babel.utilR	R
RRR
Rt__all__t
__docformat__tcompileR;tobjectRt	ExceptionRR�R(((s:/usr/lib/python2.7/site-packages/babel/messages/catalog.pyt<module>s(.		~