�
��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__scCsg|j|�}|jj|�}|r�|jrU|jrU|j|_|j|_ntt|j|j��|_tt|j |j ��|_ tt|j
|j
��|_
|j|jO_|}n�|dkr>t|jj
|j��}|j�|_djg|j
D]}d|^q�|_|j|_n%t|ttf�rVn||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
R�s
s# %sN(R�RIRnRRRRR
RRRRRtencodeRPtitemsR�RlRXR5RR7(R!RtmessageR�tcurrentRdR\((s:/usr/lib/python2.7/site-packages/babel/messages/catalog.pyt__setitem__)s. #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(. ~
|