Ñò
ž²Hc @ st d Z d d k l Z d d k l Z d d k l Z d d k l Z d d k l Z d d k Z y e
Wn# e j
o d d k l
Z
n Xd d k Z d d k l Z d d
k l Z d d k l Z d d k l Z d d
k l Z l Z l Z l Z l Z d d d g Z d Z e i d ƒ Z! d e" f d „ ƒ YZ# d e$ f d „ ƒ YZ% d Z& d e" f d „ ƒ YZ' d S( s% Data structures for message catalogs.iÿÿÿÿ( t parse_header( t datetime( t get_close_matches( t message_from_string( t copyN( t Set( t __version__( t Locale( t format_datetime( t
get_plural( t odictt distinctt LOCALTZt UTCt FixedOffsetTimezonet Messaget Catalogt TranslationErrors restructuredtext ens¬ (?x)
\%
(?:\(([\w]*)\))?
(
[-#0\ +]?(?:\*|[\d]+)?
(?:\.(?:\*|[\d]+))?
[hlL]?
)
([diouxXeEfFgGcrs%])
c B s¤ e Z d Z d d d d d d d d „ Z d „ Z d „ Z d „ Z d d „ Z d „ Z e
e d d ƒZ d
„ Z e
e d d ƒZ d „ Z e
e d d
ƒZ RS( s0 Representation of a single message in a catalog.u c C sí | | _ | o | i o
d } n | | _ t t | ƒ ƒ | _ t | ƒ | _ | o | i o | i i d ƒ n | i i
d ƒ t t | ƒ ƒ | _ t t | ƒ ƒ | _ t
| t ƒ o | g | _ n t | ƒ | _ | | _ d S( s4 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 ``(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
u s
python-formatN( u u ( t idt pluralizablet stringt listR t locationst sett flagst
python_formatt addt discardt
auto_commentst
user_commentst
isinstancet
basestringt previous_idt lineno( t selfR R R R R R R R! ( ( s: /usr/lib/python2.6/site-packages/babel/messages/catalog.pyt __init__5 s
c C s& d t | ƒ i | i t | i ƒ f S( Ns <%s %r (flags: %r)>( t typet __name__R R R ( R" ( ( s: /usr/lib/python2.6/site-packages/babel/messages/catalog.pyt __repr__X s c C s¡ t | t ƒ o~ | i } | i } | o# | o t | i d | i d ƒ S| o t | i d | i ƒ S| o t | i | i d ƒ Sn t | i | i ƒ S( s0 Compare Messages, taking into account plural idsi ( R R R t cmpR ( R" t objt pluralt
obj_plural( ( s: /usr/lib/python2.6/site-packages/babel/messages/catalog.pyt __cmp__\ s c C sC t t t | i | i | i | i | i | i | i | i
f ƒ Œ S( N( R t mapR R R R R R R R R! ( R" ( ( s: /usr/lib/python2.6/site-packages/babel/messages/catalog.pyt clonei s c C sa d d k l } g } xD | D]< } y | | | ƒ Wq t j
o } | i | ƒ q Xq W| 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ÿÿÿÿ( t checkers( t babel.messages.checkersR. R t append( R" t catalogR. t errorst checkert e( ( s: /usr/lib/python2.6/site-packages/babel/messages/catalog.pyt checko s
c C s
d | i j S( Nt fuzzy( R ( R" ( ( s: /usr/lib/python2.6/site-packages/babel/messages/catalog.pyR6 ‚ s t docs Whether the translation is fuzzy.
>>> Message('foo').fuzzy
False
>>> msg = Message('foo', 'foo', flags=['fuzzy'])
>>> msg.fuzzy
True
>>> msg
:type: `bool`
c C s t | i t t f ƒ S( N( R R R t tuple( R" ( ( s: /usr/lib/python2.6/site-packages/babel/messages/catalog.pyR ’ s sÀ Whether the message is plurizable.
>>> Message('foo').pluralizable
False
>>> Message(('foo', 'bar')).pluralizable
True
:type: `bool`
c C sc | i } t | t t f ƒ p
| g } n t t d g } | D] } | t i | ƒ q@ ~ ƒ ƒ S( N( R R R R8 t boolt filtert Nonet
PYTHON_FORMATt search( R" t idst _[1]R ( ( s: /usr/lib/python2.6/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- R5 R6 t propertyR R ( ( ( s: /usr/lib/python2.6/site-packages/babel/messages/catalog.pyR 2 s "
c B s e Z d Z RS( s_ Exception thrown by translation checkers when invalid message
translations are encountered.( R% R@ RA ( ( ( s: /usr/lib/python2.6/site-packages/babel/messages/catalog.pyR ° s u¸ # Translations template for PROJECT.
# Copyright (C) YEAR ORGANIZATION
# This file is distributed under the same license as the PROJECT project.
# FIRST AUTHOR , YEAR.
#c B sX e Z d Z d d e d d d d d d d d d e d „
Z d „ Z d „ Z e e e d d ƒZ
d „ Z d „ Z e e e d d ƒZ
d
„ Z e e d d ƒZ d „ Z e e d d
ƒZ d „ Z e e d d ƒZ d „ Z d „ Z d „ Z d „ Z d „ Z d „ Z d „ Z d d d d d d d d „ Z d „ Z e d „ Z d „ Z RS(! s$ Representation of a message catalog.s utf-8c C s | | _ | o t i | ƒ } n | | _ | | _ t ƒ | _ | p d | _ | p d | _ | p d | _ | p d | _
|
p d | _ | p d | _ | p d | _
| d j o t i t ƒ } n2 t | t ƒ o! | i o | i d t ƒ } n | | _ | d j o t i t ƒ } n2 t | t ƒ o! | i o | i d t ƒ } n | | _ |
| _ t ƒ | _ d | _ d | _ d S(
s0 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
:param fuzzy: the fuzzy bit on the catalog header
t PROJECTt VERSIONt ORGANIZATIONs
EMAIL@ADDRESSs FULL NAME s LANGUAGE s utf-8t tzinfoN( t domainR t parset localet _header_commentR
t _messagest projectt versiont copyright_holdert msgid_bugs_addresst last_translatort
language_teamt charsetR; R t nowR R RF t replacet
creation_datet
revision_dateR6 t obsoletet _num_pluralst _plural_expr( R" RI RG t header_commentRL RM RN RO RU RV RP RQ RR R6 ( ( s: /usr/lib/python2.6/site-packages/babel/messages/catalog.pyR# À s6
c C s‚ | i } | i d | i ƒ i d | i ƒ i d | i i d ƒ ƒ i d | i ƒ } | i o | i d d | i i ƒ } n | S( NRC RD t YEARs %YRE s Translations templates %s translations( RJ RT RL RM RV t strftimeRN RI t english_name( R" t comment( ( s: /usr/lib/python2.6/site-packages/babel/messages/catalog.pyt _get_header_commentü s
c C s
| | _ d S( N( RJ ( R" R ( ( s: /usr/lib/python2.6/site-packages/babel/messages/catalog.pyt _set_header_comment s R7 sƒ 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 , ....
#
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`
c C sj g } | i d d | i | i f f ƒ | i d | i f ƒ | i d t | i d d d ƒf ƒ | i d j o+ | i d ƒ | i d ƒ | i d ƒ n} | i d t | i d d d ƒf ƒ | i d
| i f ƒ | i d | i
i d t | i ƒ ƒ f ƒ | i d | i
f ƒ | i d ƒ | i d d | i f ƒ | i d ƒ | i d d t f ƒ | S( Ns Project-Id-Versions %s %ss Report-Msgid-Bugs-Tos POT-Creation-Dates yyyy-MM-dd HH:mmZRI t ens PO-Revision-Dates YEAR-MO-DA HO:MI+ZONEs Last-Translators FULL NAME s
Language-Teams LANGUAGE t LANGUAGEs Plural-Formss MIME-Versions 1.0s Content-Types text/plain; charset=%ss Content-Transfer-Encodingt 8bits Generated-Bys Babel %s
( s PO-Revision-Dates YEAR-MO-DA HO:MI+ZONE( s Last-Translators FULL NAME ( s
Language-Teams LANGUAGE ( s MIME-Versions 1.0( s Content-Transfer-EncodingRc ( R0 RL RM RO R RU RI R; RV RP RQ RT t strt plural_formsRR RD ( R" t headers( ( s: /usr/lib/python2.6/site-packages/babel/messages/catalog.pyt _get_mime_headers+ s2
c C s. xb | D]Z \ } } | i ƒ d j o; t | ƒ \ } } d | j o | d i ƒ | _ n Pq q WxÂ| D]º\ } } | i ƒ i | i ƒ } | i | i ƒ } | d j o6 | i d ƒ } d i | d ƒ | _ | d | _ ql | d j o
| | _ ql | d j o
| | _ ql | d j o
| | _
ql | d
j oJ t d | ƒ \ } } t | i d d
ƒ ƒ | _
| i d d ƒ | _ ql | d j o t i d | d ƒ \ } } } t i | d ƒ } t i | ƒ }
t t | d
ƒ d t | d
ƒ ƒ } t i |
ƒ } | i d | ƒ | _ ql ql Wd S( Ns content-typeRR s project-id-versiont u iÿÿÿÿs report-msgid-bugs-tos last-translators
language-teams plural-formss ;t npluralsi R) s (n != 1)s pot-creation-dates [+-](\d{4})$i s %Y-%m-%d %H:%Mi< RF ( t lowerR RR t decodet splitt joinRL RM RO RP RQ t intt getRX RY t ret timet strptimet mktimeR R t
fromtimestampRT RU ( R" Rf t namet valuet mimetypet paramst partst _t tzoffsett ttt tst dt( ( s: /usr/lib/python2.6/site-packages/babel/messages/catalog.pyt _set_mime_headersG sB
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
Language-Team: LANGUAGE
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: 8bit
Generated-By: Babel ...
And here's an example of the output when the locale is set:
>>> revised = datetime(1990, 8, 3, 12, 0, tzinfo=UTC)
>>> catalog = Catalog(locale='de_DE', project='Foobar', version='1.0',
... creation_date=created, revision_date=revised,
... last_translator='John Doe ',
... language_team='de_DE ')
>>> for name, value in catalog.mime_headers:
... print '%s: %s' % (name, value)
Project-Id-Version: Foobar 1.0
Report-Msgid-Bugs-To: EMAIL@ADDRESS
POT-Creation-Date: 1990-04-01 15:30+0000
PO-Revision-Date: 1990-08-03 12:00+0000
Last-Translator: John Doe
Language-Team: de_DE
Plural-Forms: nplurals=2; plural=(n != 1)
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: 8bit
Generated-By: Babel ...
:type: `list`
c C sK | i d j o4 d } | i o t | i ƒ d } n | | _ n | i S( Ni i ( RX R; RI R ( R" t num( ( s: /usr/lib/python2.6/site-packages/babel/messages/catalog.pyt num_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`
c C sK | i d j o4 d } | i o t | i ƒ d } n | | _ n | i S( Ns (n != 1)i ( RY R; RI R ( R" t expr( ( s: /usr/lib/python2.6/site-packages/babel/messages/catalog.pyt plural_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`
c C s d | i | i f S( Ns nplurals=%s; plural=%s( R Rƒ ( R" ( ( s: /usr/lib/python2.6/site-packages/babel/messages/catalog.pyRe ¿ s sé 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`
c C s | i | ƒ | i j S( s? Return whether the catalog has a message with the specified ID.( t _key_forRK ( R" R ( ( s: /usr/lib/python2.6/site-packages/babel/messages/catalog.pyt __contains__Ì s c C s
t | i ƒ S( sn The number of messages in the catalog.
This does not include the special ``msgid ""`` entry.
( t lenRK ( R" ( ( s: /usr/lib/python2.6/site-packages/babel/messages/catalog.pyt __len__Ð s c c s¢ g } x. | i D]# \ } } | i d | | f ƒ q Wt ƒ } | i o | t d g ƒ O} n t d d i | ƒ d | ƒVx | i D] } | i | Vqˆ Wd S( 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: %sR6 u s
R N( t mime_headersR0 R R6 R Rm RK ( R" t bufRu Rv R t key( ( s: /usr/lib/python2.6/site-packages/babel/messages/catalog.pyt __iter__× s
c C s> d } | i o d | i } n d t | ƒ i | i | f S( Nt s %ss <%s %r%s>( RI R$ R% RG ( R" RI ( ( s: /usr/lib/python2.6/site-packages/babel/messages/catalog.pyR& ç s
c C s1 | i | ƒ } | | i j o | i | =n d S( s) Delete the message with the specified ID.N( R„ RK ( R" R RŠ ( ( s: /usr/lib/python2.6/site-packages/babel/messages/catalog.pyt __delitem__í s c C s | i i | i | ƒ ƒ 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`
( RK Ro R„ ( R" R ( ( s: /usr/lib/python2.6/site-packages/babel/messages/catalog.pyt __getitem__ó s c C sx | i | ƒ } | i i | ƒ } | oª | i o' | i o | i | _ | i | _ n t t | i | i ƒ ƒ | _ t t | i | i ƒ ƒ | _ t t | i
| i
ƒ ƒ | _
| i | i O_ | } n£ | d j on t | i i
| i ƒ ƒ } | i ƒ | _ d i g } | i
D] } | d | q ~ ƒ | _ | i | _ n( t | t t f ƒ o n | | i | >> catalog = Catalog()
>>> catalog[u'foo'] = Message(u'foo')
>>> catalog[u'foo']
If a message with that ID is already in the catalog, it is updated
to include the locations and flags of the new message.
>>> catalog = Catalog()
>>> catalog[u'foo'] = Message(u'foo', locations=[('main.py', 1)])
>>> catalog[u'foo'].locations
[('main.py', 1)]
>>> catalog[u'foo'] = Message(u'foo', locations=[('utils.py', 5)])
>>> catalog[u'foo'].locations
[('main.py', 1), ('utils.py', 5)]
:param id: the message ID
:param message: the `Message` object
RΠs
s # %sN( R„ RK Ro R R R R R R R R R R t encodeRR t itemsRˆ Rm RZ R6 R R8 ( R" R t messageRŠ t currentRf R? R^ ( ( s: /usr/lib/python2.6/site-packages/babel/messages/catalog.pyt __setitem__ý s.
'c
C s2 t | | t | ƒ | | | | d | ƒ| | >> catalog = Catalog()
>>> catalog.add(u'foo')
>>> catalog[u'foo']
This method simply constructs a `Message` object with the given
arguments and invokes `__setitem__` with that object.
:param id: the message ID, or a ``(singular, plural)`` tuple for
pluralizable messages
:param string: the translated message string, or a
``(singular, plural)`` tuple for pluralizable messages
:param locations: a sequence of ``(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( R R ( R" R R R R R R R R! ( ( s: /usr/lib/python2.6/site-packages/babel/messages/catalog.pyR 0 s c c sF x? | i i ƒ D]. } | i d | ƒ } | o | | f Vq q Wd S( sB 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: ``iterator``
R1 N( RK t valuesR5 ( R" R‘ R2 ( ( s: /usr/lib/python2.6/site-packages/babel/messages/catalog.pyR5 L s
c
s ˆ i ‰ ˆ i ƒ ‰ t ƒ ˆ _ g } | pG g } ˆ D]/ } | o" ˆ | i o | ˆ i | ƒ q9 q9 ~ } n t ƒ ‰ ‡ ‡ ‡ ‡ f d † } x | D]¥ } | i o• ˆ i | i ƒ } | ˆ j o | | | | ƒ qB| t j oD t | i ƒ i
ƒ | d ƒ } | o | | | d | ƒ q q1n | ˆ | i >> 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()
[]
:param template: the reference catalog, usually read from a POT file
:param no_fuzzy_matching: whether to use fuzzy matching of message IDs
c sÉ | i ƒ } t } | | j o^ t } ˆ i | ƒ ˆ i | ƒ } t | i t ƒ o | i g | _ q t | i ƒ | _ n ˆ i
| d ƒ } | i | _ t | i t t
f ƒ oœ t | i t t
f ƒ p7 t } t
| i g d g t | i ƒ d ƒ | _ qƒt | i ƒ t | i ƒ j o) t } t
| i t | i ƒ ƒ | _ qƒn4 t | i t t
f ƒ o t } | i d | _ n | i | i O_ | o | i t d g ƒ O_ n | ˆ | i s0 ( ~