1
<?xml version="1.0" encoding="ascii"?>
2
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
3
"DTD/xhtml1-transitional.dtd">
4
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
6
<title>babel.messages.catalog.Message</title>
7
<link rel="stylesheet" href="epydoc.css" type="text/css" />
8
<script type="text/javascript" src="epydoc.js"></script>
11
<body bgcolor="white" text="black" link="blue" vlink="#204080"
13
<!-- ==================== NAVIGATION BAR ==================== -->
14
<table class="navbar" border="0" width="100%" cellpadding="0"
15
bgcolor="#a0c0ff" cellspacing="0">
18
<th> <a
19
href="babel-module.html">Home</a> </th>
22
<th> <a
23
href="module-tree.html">Trees</a> </th>
26
<th> <a
27
href="identifier-index.html">Indices</a> </th>
30
<th> <a
31
href="help.html">Help</a> </th>
33
<!-- Project homepage -->
34
<th class="navbar" align="right" width="100%">
35
<table border="0" cellpadding="0" cellspacing="0">
36
<tr><th class="navbar" align="center"
37
><a class="navbar" target="_top" href="../index.html">Documentation Index</a></th>
41
<table width="100%" cellpadding="0" cellspacing="0">
44
<span class="breadcrumbs">
45
<a href="babel-module.html">Package babel</a> ::
46
<a href="babel.messages-module.html">Package messages</a> ::
47
<a href="babel.messages.catalog-module.html">Module catalog</a> ::
52
<table cellpadding="0" cellspacing="0">
53
<!-- hide/show private -->
58
<!-- ==================== CLASS DESCRIPTION ==================== -->
59
<h1 class="epydoc">Class Message</h1><p class="nomargin-top"></p>
60
<pre class="base-tree">
63
<strong class="uidshort">Message</strong>
67
Representation of a single message in a catalog.
69
<!-- ==================== INSTANCE METHODS ==================== -->
70
<a name="section-InstanceMethods"></a>
71
<table class="summary" border="1" cellpadding="3"
72
cellspacing="0" width="100%" bgcolor="white">
73
<tr bgcolor="#70b0f0" class="table-header">
74
<td align="left" colspan="2" class="table-header">
75
<span class="table-header">Instance Methods</span></td>
78
<td width="15%" align="right" valign="top" class="summary">
79
<span class="summary-type"> </span>
80
</td><td class="summary">
81
<table width="100%" cellpadding="0" cellspacing="0" border="0">
83
<td><span class="summary-sig"><a href="babel.messages.catalog.Message-class.html#__init__" class="summary-sig-name">__init__</a>(<span class="summary-sig-arg">self</span>,
84
<span class="summary-sig-arg">id</span>,
85
<span class="summary-sig-arg">string</span>=<span class="summary-sig-default"><code class="variable-quote">u'</code><code class="variable-string"></code><code class="variable-quote">'</code></span>,
86
<span class="summary-sig-arg">locations</span>=<span class="summary-sig-default"><code class="variable-group">(</code><code class="variable-group">)</code></span>,
87
<span class="summary-sig-arg">flags</span>=<span class="summary-sig-default"><code class="variable-group">(</code><code class="variable-group">)</code></span>,
88
<span class="summary-sig-arg">auto_comments</span>=<span class="summary-sig-default"><code class="variable-group">(</code><code class="variable-group">)</code></span>,
89
<span class="summary-sig-arg">user_comments</span>=<span class="summary-sig-default"><code class="variable-group">(</code><code class="variable-group">)</code></span>,
90
<span class="summary-sig-arg">previous_id</span>=<span class="summary-sig-default"><code class="variable-group">(</code><code class="variable-group">)</code></span>,
91
<span class="summary-sig-arg">lineno</span>=<span class="summary-sig-default">None</span>)</span><br />
92
Create the message object.</td>
93
<td align="right" valign="top">
103
<td width="15%" align="right" valign="top" class="summary">
104
<span class="summary-type"> </span>
105
</td><td class="summary">
106
<table width="100%" cellpadding="0" cellspacing="0" border="0">
108
<td><span class="summary-sig"><a href="babel.messages.catalog.Message-class.html#__repr__" class="summary-sig-name">__repr__</a>(<span class="summary-sig-arg">self</span>)</span><br />
110
<td align="right" valign="top">
120
<td width="15%" align="right" valign="top" class="summary">
121
<span class="summary-type"> </span>
122
</td><td class="summary">
123
<table width="100%" cellpadding="0" cellspacing="0" border="0">
125
<td><span class="summary-sig"><a name="__cmp__"></a><span class="summary-sig-name">__cmp__</span>(<span class="summary-sig-arg">self</span>,
126
<span class="summary-sig-arg">obj</span>)</span><br />
127
Compare Messages, taking into account plural ids</td>
128
<td align="right" valign="top">
138
<td width="15%" align="right" valign="top" class="summary">
139
<span class="summary-type"> </span>
140
</td><td class="summary">
141
<table width="100%" cellpadding="0" cellspacing="0" border="0">
143
<td><span class="summary-sig"><a name="clone"></a><span class="summary-sig-name">clone</span>(<span class="summary-sig-arg">self</span>)</span></td>
144
<td align="right" valign="top">
154
<td width="15%" align="right" valign="top" class="summary">
155
<span class="summary-type"><tt class="rst-docutils literal">iterator</tt></span>
156
</td><td class="summary">
157
<table width="100%" cellpadding="0" cellspacing="0" border="0">
159
<td><span class="summary-sig"><a href="babel.messages.catalog.Message-class.html#check" class="summary-sig-name">check</a>(<span class="summary-sig-arg">self</span>,
160
<span class="summary-sig-arg">catalog</span>=<span class="summary-sig-default">None</span>)</span><br />
161
Run various validation checks on the message.</td>
162
<td align="right" valign="top">
172
<td colspan="2" class="summary">
173
<p class="indent-wrapped-lines"><b>Inherited from <code>object</code></b>:
174
<code>__delattr__</code>,
175
<code>__format__</code>,
176
<code>__getattribute__</code>,
177
<code>__hash__</code>,
178
<code>__new__</code>,
179
<code>__reduce__</code>,
180
<code>__reduce_ex__</code>,
181
<code>__setattr__</code>,
182
<code>__sizeof__</code>,
183
<code>__str__</code>,
184
<code>__subclasshook__</code>
189
<!-- ==================== INSTANCE VARIABLES ==================== -->
190
<a name="section-InstanceVariables"></a>
191
<table class="summary" border="1" cellpadding="3"
192
cellspacing="0" width="100%" bgcolor="white">
193
<tr bgcolor="#70b0f0" class="table-header">
194
<td align="left" colspan="2" class="table-header">
195
<span class="table-header">Instance Variables</span></td>
198
<td width="15%" align="right" valign="top" class="summary">
199
<span class="summary-type"> </span>
200
</td><td class="summary">
201
<a name="id"></a><span class="summary-name">id</span><br />
206
<td width="15%" align="right" valign="top" class="summary">
207
<span class="summary-type"> </span>
208
</td><td class="summary">
209
<a name="string"></a><span class="summary-name">string</span><br />
210
The message translation
214
<!-- ==================== PROPERTIES ==================== -->
215
<a name="section-Properties"></a>
216
<table class="summary" border="1" cellpadding="3"
217
cellspacing="0" width="100%" bgcolor="white">
218
<tr bgcolor="#70b0f0" class="table-header">
219
<td align="left" colspan="2" class="table-header">
220
<span class="table-header">Properties</span></td>
223
<td width="15%" align="right" valign="top" class="summary">
224
<span class="summary-type"><code class="link">bool</code></span>
225
</td><td class="summary">
226
<a href="babel.messages.catalog.Message-class.html#fuzzy" class="summary-name">fuzzy</a><br />
227
Whether the translation is fuzzy.
231
<td width="15%" align="right" valign="top" class="summary">
232
<span class="summary-type"><code class="link">bool</code></span>
233
</td><td class="summary">
234
<a href="babel.messages.catalog.Message-class.html#pluralizable" class="summary-name">pluralizable</a><br />
235
Whether the message is plurizable.
239
<td width="15%" align="right" valign="top" class="summary">
240
<span class="summary-type"><code class="link">bool</code></span>
241
</td><td class="summary">
242
<a href="babel.messages.catalog.Message-class.html#python_format" class="summary-name">python_format</a><br />
243
Whether the message contains Python-style parameters.
247
<td colspan="2" class="summary">
248
<p class="indent-wrapped-lines"><b>Inherited from <code>object</code></b>:
249
<code>__class__</code>
254
<!-- ==================== METHOD DETAILS ==================== -->
255
<a name="section-MethodDetails"></a>
256
<table class="details" border="1" cellpadding="3"
257
cellspacing="0" width="100%" bgcolor="white">
258
<tr bgcolor="#70b0f0" class="table-header">
259
<td align="left" colspan="2" class="table-header">
260
<span class="table-header">Method Details</span></td>
263
<a name="__init__"></a>
265
<table class="details" border="1" cellpadding="3"
266
cellspacing="0" width="100%" bgcolor="white">
268
<table width="100%" cellpadding="0" cellspacing="0" border="0">
269
<tr valign="top"><td>
270
<h3 class="epydoc"><span class="sig"><span class="sig-name">__init__</span>(<span class="sig-arg">self</span>,
271
<span class="sig-arg">id</span>,
272
<span class="sig-arg">string</span>=<span class="sig-default"><code class="variable-quote">u'</code><code class="variable-string"></code><code class="variable-quote">'</code></span>,
273
<span class="sig-arg">locations</span>=<span class="sig-default"><code class="variable-group">(</code><code class="variable-group">)</code></span>,
274
<span class="sig-arg">flags</span>=<span class="sig-default"><code class="variable-group">(</code><code class="variable-group">)</code></span>,
275
<span class="sig-arg">auto_comments</span>=<span class="sig-default"><code class="variable-group">(</code><code class="variable-group">)</code></span>,
276
<span class="sig-arg">user_comments</span>=<span class="sig-default"><code class="variable-group">(</code><code class="variable-group">)</code></span>,
277
<span class="sig-arg">previous_id</span>=<span class="sig-default"><code class="variable-group">(</code><code class="variable-group">)</code></span>,
278
<span class="sig-arg">lineno</span>=<span class="sig-default">None</span>)</span>
279
<br /><em class="fname">(Constructor)</em>
281
</td><td align="right" valign="top"
286
Create the message object.
289
<dd><ul class="nomargin-top">
290
<li><strong class="pname"><code>id</code></strong> - the message ID, or a <tt class="rst-docutils literal">(singular, plural)</tt> tuple for
291
pluralizable messages</li>
292
<li><strong class="pname"><code>string</code></strong> - the translated message string, or a
293
<tt class="rst-docutils literal">(singular, plural)</tt> tuple for pluralizable messages</li>
294
<li><strong class="pname"><code>locations</code></strong> - a sequence of <tt class="rst-docutils literal">(filenname, lineno)</tt> tuples</li>
295
<li><strong class="pname"><code>flags</code></strong> - a set or sequence of flags</li>
296
<li><strong class="pname"><code>auto_comments</code></strong> - a sequence of automatic comments for the message</li>
297
<li><strong class="pname"><code>user_comments</code></strong> - a sequence of user comments for the message</li>
298
<li><strong class="pname"><code>previous_id</code></strong> - the previous message ID, or a <tt class="rst-docutils literal">(singular, plural)</tt>
299
tuple for pluralizable messages</li>
300
<li><strong class="pname"><code>lineno</code></strong> - the line number on which the msgid line was found in the
309
<a name="__repr__"></a>
311
<table class="details" border="1" cellpadding="3"
312
cellspacing="0" width="100%" bgcolor="white">
314
<table width="100%" cellpadding="0" cellspacing="0" border="0">
315
<tr valign="top"><td>
316
<h3 class="epydoc"><span class="sig"><span class="sig-name">__repr__</span>(<span class="sig-arg">self</span>)</span>
317
<br /><em class="fname">(Representation operator)</em>
319
</td><td align="right" valign="top"
328
<dd><em class="note">(inherited documentation)</em></dd>
335
<table class="details" border="1" cellpadding="3"
336
cellspacing="0" width="100%" bgcolor="white">
338
<table width="100%" cellpadding="0" cellspacing="0" border="0">
339
<tr valign="top"><td>
340
<h3 class="epydoc"><span class="sig"><span class="sig-name">check</span>(<span class="sig-arg">self</span>,
341
<span class="sig-arg">catalog</span>=<span class="sig-default">None</span>)</span>
343
</td><td align="right" valign="top"
348
Run various validation checks on the message. Some validations
349
are only performed if the catalog is provided. This method returns
350
a sequence of <a href="babel.messages.catalog.TranslationError-class.html" class="link">TranslationError</a> objects.
353
<dd><ul class="nomargin-top">
354
<li><strong class="pname"><code>catalog</code></strong> - A catalog instance that is passed to the checkers</li>
356
<dt>Returns: <tt class="rst-rst-docutils literal rst-docutils literal">iterator</tt></dt>
358
<div class="fields"> <p><strong>See Also:</strong>
359
<a href="babel.messages.catalog.Catalog-class.html#check" class="link">Catalog.check</a> for a way to perform checks for all messages
362
</div></td></tr></table>
365
<!-- ==================== PROPERTY DETAILS ==================== -->
366
<a name="section-PropertyDetails"></a>
367
<table class="details" border="1" cellpadding="3"
368
cellspacing="0" width="100%" bgcolor="white">
369
<tr bgcolor="#70b0f0" class="table-header">
370
<td align="left" colspan="2" class="table-header">
371
<span class="table-header">Property Details</span></td>
376
<table class="details" border="1" cellpadding="3"
377
cellspacing="0" width="100%" bgcolor="white">
379
<h3 class="epydoc">fuzzy</h3>
380
<p>Whether the translation is fuzzy.</p>
381
<pre class="py-doctest">
382
<span class="py-prompt">>>> </span>Message(<span class="py-string">'foo'</span>).fuzzy
383
<span class="py-output">False</span>
384
<span class="py-output"></span><span class="py-prompt">>>> </span>msg = Message(<span class="py-string">'foo'</span>, <span class="py-string">'foo'</span>, flags=[<span class="py-string">'fuzzy'</span>])
385
<span class="py-prompt">>>> </span>msg.fuzzy
386
<span class="py-output">True</span>
387
<span class="py-output"></span><span class="py-prompt">>>> </span>msg
388
<span class="py-output"><Message 'foo' (flags: ['fuzzy'])></span></pre>
391
<dd class="value"><span class="summary-sig"><i>unreachable</i>.fuzzy(<span class="summary-sig-arg">self</span>)</span>
394
<dd><code class="link">bool</code></dd>
398
<a name="pluralizable"></a>
400
<table class="details" border="1" cellpadding="3"
401
cellspacing="0" width="100%" bgcolor="white">
403
<h3 class="epydoc">pluralizable</h3>
404
<p>Whether the message is plurizable.</p>
405
<pre class="py-doctest">
406
<span class="py-prompt">>>> </span>Message(<span class="py-string">'foo'</span>).pluralizable
407
<span class="py-output">False</span>
408
<span class="py-output"></span><span class="py-prompt">>>> </span>Message((<span class="py-string">'foo'</span>, <span class="py-string">'bar'</span>)).pluralizable
409
<span class="py-output">True</span></pre>
412
<dd class="value"><span class="summary-sig"><i>unreachable</i>.pluralizable(<span class="summary-sig-arg">self</span>)</span>
415
<dd><code class="link">bool</code></dd>
419
<a name="python_format"></a>
421
<table class="details" border="1" cellpadding="3"
422
cellspacing="0" width="100%" bgcolor="white">
424
<h3 class="epydoc">python_format</h3>
425
<p>Whether the message contains Python-style parameters.</p>
426
<pre class="py-doctest">
427
<span class="py-prompt">>>> </span>Message(<span class="py-string">'foo %(name)s bar'</span>).python_format
428
<span class="py-output">True</span>
429
<span class="py-output"></span><span class="py-prompt">>>> </span>Message((<span class="py-string">'foo %(name)s'</span>, <span class="py-string">'foo %(name)s'</span>)).python_format
430
<span class="py-output">True</span></pre>
433
<dd class="value"><span class="summary-sig"><i>unreachable</i>.python_format(<span class="summary-sig-arg">self</span>)</span>
436
<dd><code class="link">bool</code></dd>
441
<!-- ==================== NAVIGATION BAR ==================== -->
442
<table class="navbar" border="0" width="100%" cellpadding="0"
443
bgcolor="#a0c0ff" cellspacing="0">
446
<th> <a
447
href="babel-module.html">Home</a> </th>
450
<th> <a
451
href="module-tree.html">Trees</a> </th>
454
<th> <a
455
href="identifier-index.html">Indices</a> </th>
458
<th> <a
459
href="help.html">Help</a> </th>
461
<!-- Project homepage -->
462
<th class="navbar" align="right" width="100%">
463
<table border="0" cellpadding="0" cellspacing="0">
464
<tr><th class="navbar" align="center"
465
><a class="navbar" target="_top" href="../index.html">Documentation Index</a></th>
469
<table border="0" cellpadding="0" cellspacing="0" width="100%%">
471
<td align="left" class="footer">
472
Generated by Epydoc 3.0.1 on Thu Mar 17 15:12:44 2011
474
<td align="right" class="footer">
475
<a target="mainFrame" href="http://epydoc.sourceforge.net"
476
>http://epydoc.sourceforge.net</a>
481
<script type="text/javascript">
483
// Private objects are initially displayed (because if
484
// javascript is turned off then we want them to be
485
// visible); but by default, we want to hide them. So hide
486
// them unless we have a cookie that says to show them.