|
1 <!DOCTYPE html> |
|
2 <html><head> |
|
3 <title>Plugin_Project_Flask.ProjectFlask.FlaskBabelExtension.PyBabelProjectExtension</title> |
|
4 <meta charset="UTF-8"> |
|
5 <style> |
|
6 body { |
|
7 background: #EDECE6; |
|
8 margin: 0em 1em 10em 1em; |
|
9 color: black; |
|
10 } |
|
11 |
|
12 h1 { color: white; background: #85774A; } |
|
13 h2 { color: white; background: #85774A; } |
|
14 h3 { color: white; background: #9D936E; } |
|
15 h4 { color: white; background: #9D936E; } |
|
16 |
|
17 a { color: #BA6D36; } |
|
18 |
|
19 </style> |
|
20 </head> |
|
21 <body> |
|
22 <a NAME="top" ID="top"></a> |
|
23 <h1>Plugin_Project_Flask.ProjectFlask.FlaskBabelExtension.PyBabelProjectExtension</h1> |
|
24 |
|
25 <p> |
|
26 Module implementing the project support for flask-babel. |
|
27 </p> |
|
28 <h3>Global Attributes</h3> |
|
29 |
|
30 <table> |
|
31 <tr><td>None</td></tr> |
|
32 </table> |
|
33 <h3>Classes</h3> |
|
34 |
|
35 <table> |
|
36 |
|
37 <tr> |
|
38 <td><a href="#PyBabelProject">PyBabelProject</a></td> |
|
39 <td>Class implementing the Flask project support.</td> |
|
40 </tr> |
|
41 </table> |
|
42 <h3>Functions</h3> |
|
43 |
|
44 <table> |
|
45 <tr><td>None</td></tr> |
|
46 </table> |
|
47 <hr /> |
|
48 <hr /> |
|
49 <a NAME="PyBabelProject" ID="PyBabelProject"></a> |
|
50 <h2>PyBabelProject</h2> |
|
51 |
|
52 <p> |
|
53 Class implementing the Flask project support. |
|
54 </p> |
|
55 <h3>Derived from</h3> |
|
56 QObject |
|
57 <h3>Class Attributes</h3> |
|
58 |
|
59 <table> |
|
60 <tr><td>None</td></tr> |
|
61 </table> |
|
62 <h3>Class Methods</h3> |
|
63 |
|
64 <table> |
|
65 <tr><td>None</td></tr> |
|
66 </table> |
|
67 <h3>Methods</h3> |
|
68 |
|
69 <table> |
|
70 |
|
71 <tr> |
|
72 <td><a href="#PyBabelProject.__init__">PyBabelProject</a></td> |
|
73 <td>Constructor</td> |
|
74 </tr> |
|
75 <tr> |
|
76 <td><a href="#PyBabelProject.__createBabelCfg">__createBabelCfg</a></td> |
|
77 <td>Private method to create a template pybabel configuration file.</td> |
|
78 </tr> |
|
79 <tr> |
|
80 <td><a href="#PyBabelProject.__ensurePybabelConfigured">__ensurePybabelConfigured</a></td> |
|
81 <td>Private method to ensure, that PyBabel has been configured.</td> |
|
82 </tr> |
|
83 <tr> |
|
84 <td><a href="#PyBabelProject.__getLocale">__getLocale</a></td> |
|
85 <td>Private method to extract the locale out of a file name.</td> |
|
86 </tr> |
|
87 <tr> |
|
88 <td><a href="#PyBabelProject.__projectLanguageAdded">__projectLanguageAdded</a></td> |
|
89 <td>Private slot handling the addition of a new language.</td> |
|
90 </tr> |
|
91 <tr> |
|
92 <td><a href="#PyBabelProject.compileCatalogs">compileCatalogs</a></td> |
|
93 <td>Public method to compile the message catalogs.</td> |
|
94 </tr> |
|
95 <tr> |
|
96 <td><a href="#PyBabelProject.compileSelectedCatalogs">compileSelectedCatalogs</a></td> |
|
97 <td>Public method to update the message catalogs.</td> |
|
98 </tr> |
|
99 <tr> |
|
100 <td><a href="#PyBabelProject.configurePyBabel">configurePyBabel</a></td> |
|
101 <td>Public slot to show a dialog to edit the pybabel configuration.</td> |
|
102 </tr> |
|
103 <tr> |
|
104 <td><a href="#PyBabelProject.determineCapability">determineCapability</a></td> |
|
105 <td>Public method to determine the availability of flask-babel.</td> |
|
106 </tr> |
|
107 <tr> |
|
108 <td><a href="#PyBabelProject.extractMessages">extractMessages</a></td> |
|
109 <td>Public method to extract the messages catalog template file.</td> |
|
110 </tr> |
|
111 <tr> |
|
112 <td><a href="#PyBabelProject.flaskBabelAvailable">flaskBabelAvailable</a></td> |
|
113 <td>Public method to check, if the 'flask-babel' package is available.</td> |
|
114 </tr> |
|
115 <tr> |
|
116 <td><a href="#PyBabelProject.getBabelCommand">getBabelCommand</a></td> |
|
117 <td>Public method to build the Babel command.</td> |
|
118 </tr> |
|
119 <tr> |
|
120 <td><a href="#PyBabelProject.openPOEditor">openPOEditor</a></td> |
|
121 <td>Public method to edit the given file in an external .po editor.</td> |
|
122 </tr> |
|
123 <tr> |
|
124 <td><a href="#PyBabelProject.projectClosedHooks">projectClosedHooks</a></td> |
|
125 <td>Public method to remove our hook methods.</td> |
|
126 </tr> |
|
127 <tr> |
|
128 <td><a href="#PyBabelProject.projectOpenedHooks">projectOpenedHooks</a></td> |
|
129 <td>Public method to add our hook methods.</td> |
|
130 </tr> |
|
131 <tr> |
|
132 <td><a href="#PyBabelProject.registerOpenHook">registerOpenHook</a></td> |
|
133 <td>Public method to register the open hook to open a translations file in a translations editor.</td> |
|
134 </tr> |
|
135 <tr> |
|
136 <td><a href="#PyBabelProject.updateCatalogs">updateCatalogs</a></td> |
|
137 <td>Public method to update the message catalogs.</td> |
|
138 </tr> |
|
139 <tr> |
|
140 <td><a href="#PyBabelProject.updateCatalogsObsolete">updateCatalogsObsolete</a></td> |
|
141 <td>Public method to update the message catalogs keeping obsolete translations.</td> |
|
142 </tr> |
|
143 <tr> |
|
144 <td><a href="#PyBabelProject.updateSelectedCatalogs">updateSelectedCatalogs</a></td> |
|
145 <td>Public method to update the selected message catalogs.</td> |
|
146 </tr> |
|
147 <tr> |
|
148 <td><a href="#PyBabelProject.updateSelectedCatalogsObsolete">updateSelectedCatalogsObsolete</a></td> |
|
149 <td>Public method to update the message catalogs keeping obsolete translations.</td> |
|
150 </tr> |
|
151 </table> |
|
152 <h3>Static Methods</h3> |
|
153 |
|
154 <table> |
|
155 <tr><td>None</td></tr> |
|
156 </table> |
|
157 |
|
158 <a NAME="PyBabelProject.__init__" ID="PyBabelProject.__init__"></a> |
|
159 <h4>PyBabelProject (Constructor)</h4> |
|
160 <b>PyBabelProject</b>(<i>plugin, project, parent=None</i>) |
|
161 |
|
162 <p> |
|
163 Constructor |
|
164 </p> |
|
165 <dl> |
|
166 |
|
167 <dt><i>plugin</i> (ProjectFlaskPlugin)</dt> |
|
168 <dd> |
|
169 reference to the plugin object |
|
170 </dd> |
|
171 <dt><i>project</i> (Project)</dt> |
|
172 <dd> |
|
173 reference to the project object |
|
174 </dd> |
|
175 <dt><i>parent</i> (QObject)</dt> |
|
176 <dd> |
|
177 parent |
|
178 </dd> |
|
179 </dl> |
|
180 <a NAME="PyBabelProject.__createBabelCfg" ID="PyBabelProject.__createBabelCfg"></a> |
|
181 <h4>PyBabelProject.__createBabelCfg</h4> |
|
182 <b>__createBabelCfg</b>(<i>configFile</i>) |
|
183 |
|
184 <p> |
|
185 Private method to create a template pybabel configuration file. |
|
186 </p> |
|
187 <dl> |
|
188 |
|
189 <dt><i>configFile</i> (str)</dt> |
|
190 <dd> |
|
191 name of the configuration file to be created |
|
192 </dd> |
|
193 </dl> |
|
194 <dl> |
|
195 <dt>Returns:</dt> |
|
196 <dd> |
|
197 flag indicating successful configuration file creation |
|
198 </dd> |
|
199 </dl> |
|
200 <dl> |
|
201 <dt>Return Type:</dt> |
|
202 <dd> |
|
203 bool |
|
204 </dd> |
|
205 </dl> |
|
206 <a NAME="PyBabelProject.__ensurePybabelConfigured" ID="PyBabelProject.__ensurePybabelConfigured"></a> |
|
207 <h4>PyBabelProject.__ensurePybabelConfigured</h4> |
|
208 <b>__ensurePybabelConfigured</b>(<i></i>) |
|
209 |
|
210 <p> |
|
211 Private method to ensure, that PyBabel has been configured. |
|
212 </p> |
|
213 <dl> |
|
214 <dt>Returns:</dt> |
|
215 <dd> |
|
216 flag indicating successful configuration |
|
217 </dd> |
|
218 </dl> |
|
219 <dl> |
|
220 <dt>Return Type:</dt> |
|
221 <dd> |
|
222 bool |
|
223 </dd> |
|
224 </dl> |
|
225 <a NAME="PyBabelProject.__getLocale" ID="PyBabelProject.__getLocale"></a> |
|
226 <h4>PyBabelProject.__getLocale</h4> |
|
227 <b>__getLocale</b>(<i>filename</i>) |
|
228 |
|
229 <p> |
|
230 Private method to extract the locale out of a file name. |
|
231 </p> |
|
232 <dl> |
|
233 |
|
234 <dt><i>filename</i> (str)</dt> |
|
235 <dd> |
|
236 name of the file used for extraction |
|
237 </dd> |
|
238 </dl> |
|
239 <dl> |
|
240 <dt>Returns:</dt> |
|
241 <dd> |
|
242 extracted locale |
|
243 </dd> |
|
244 </dl> |
|
245 <dl> |
|
246 <dt>Return Type:</dt> |
|
247 <dd> |
|
248 str or None |
|
249 </dd> |
|
250 </dl> |
|
251 <a NAME="PyBabelProject.__projectLanguageAdded" ID="PyBabelProject.__projectLanguageAdded"></a> |
|
252 <h4>PyBabelProject.__projectLanguageAdded</h4> |
|
253 <b>__projectLanguageAdded</b>(<i>code</i>) |
|
254 |
|
255 <p> |
|
256 Private slot handling the addition of a new language. |
|
257 </p> |
|
258 <dl> |
|
259 |
|
260 <dt><i>code</i> (str)</dt> |
|
261 <dd> |
|
262 language code of the new language |
|
263 </dd> |
|
264 </dl> |
|
265 <a NAME="PyBabelProject.compileCatalogs" ID="PyBabelProject.compileCatalogs"></a> |
|
266 <h4>PyBabelProject.compileCatalogs</h4> |
|
267 <b>compileCatalogs</b>(<i>filenames</i>) |
|
268 |
|
269 <p> |
|
270 Public method to compile the message catalogs. |
|
271 </p> |
|
272 <dl> |
|
273 |
|
274 <dt><i>filenames</i> (list of str)</dt> |
|
275 <dd> |
|
276 list of filenames (not used) |
|
277 </dd> |
|
278 </dl> |
|
279 <a NAME="PyBabelProject.compileSelectedCatalogs" ID="PyBabelProject.compileSelectedCatalogs"></a> |
|
280 <h4>PyBabelProject.compileSelectedCatalogs</h4> |
|
281 <b>compileSelectedCatalogs</b>(<i>filenames</i>) |
|
282 |
|
283 <p> |
|
284 Public method to update the message catalogs. |
|
285 </p> |
|
286 <dl> |
|
287 |
|
288 <dt><i>filenames</i> (list of str)</dt> |
|
289 <dd> |
|
290 list of file names |
|
291 </dd> |
|
292 </dl> |
|
293 <a NAME="PyBabelProject.configurePyBabel" ID="PyBabelProject.configurePyBabel"></a> |
|
294 <h4>PyBabelProject.configurePyBabel</h4> |
|
295 <b>configurePyBabel</b>(<i></i>) |
|
296 |
|
297 <p> |
|
298 Public slot to show a dialog to edit the pybabel configuration. |
|
299 </p> |
|
300 <a NAME="PyBabelProject.determineCapability" ID="PyBabelProject.determineCapability"></a> |
|
301 <h4>PyBabelProject.determineCapability</h4> |
|
302 <b>determineCapability</b>(<i></i>) |
|
303 |
|
304 <p> |
|
305 Public method to determine the availability of flask-babel. |
|
306 </p> |
|
307 <a NAME="PyBabelProject.extractMessages" ID="PyBabelProject.extractMessages"></a> |
|
308 <h4>PyBabelProject.extractMessages</h4> |
|
309 <b>extractMessages</b>(<i></i>) |
|
310 |
|
311 <p> |
|
312 Public method to extract the messages catalog template file. |
|
313 </p> |
|
314 <a NAME="PyBabelProject.flaskBabelAvailable" ID="PyBabelProject.flaskBabelAvailable"></a> |
|
315 <h4>PyBabelProject.flaskBabelAvailable</h4> |
|
316 <b>flaskBabelAvailable</b>(<i></i>) |
|
317 |
|
318 <p> |
|
319 Public method to check, if the 'flask-babel' package is available. |
|
320 </p> |
|
321 <dl> |
|
322 <dt>Returns:</dt> |
|
323 <dd> |
|
324 flag indicating the availability of 'flask-babel' |
|
325 </dd> |
|
326 </dl> |
|
327 <dl> |
|
328 <dt>Return Type:</dt> |
|
329 <dd> |
|
330 bool |
|
331 </dd> |
|
332 </dl> |
|
333 <a NAME="PyBabelProject.getBabelCommand" ID="PyBabelProject.getBabelCommand"></a> |
|
334 <h4>PyBabelProject.getBabelCommand</h4> |
|
335 <b>getBabelCommand</b>(<i></i>) |
|
336 |
|
337 <p> |
|
338 Public method to build the Babel command. |
|
339 </p> |
|
340 <dl> |
|
341 <dt>Returns:</dt> |
|
342 <dd> |
|
343 full pybabel command |
|
344 </dd> |
|
345 </dl> |
|
346 <dl> |
|
347 <dt>Return Type:</dt> |
|
348 <dd> |
|
349 str |
|
350 </dd> |
|
351 </dl> |
|
352 <a NAME="PyBabelProject.openPOEditor" ID="PyBabelProject.openPOEditor"></a> |
|
353 <h4>PyBabelProject.openPOEditor</h4> |
|
354 <b>openPOEditor</b>(<i>poFile</i>) |
|
355 |
|
356 <p> |
|
357 Public method to edit the given file in an external .po editor. |
|
358 </p> |
|
359 <dl> |
|
360 |
|
361 <dt><i>poFile</i> (str)</dt> |
|
362 <dd> |
|
363 name of the .po file |
|
364 </dd> |
|
365 </dl> |
|
366 <a NAME="PyBabelProject.projectClosedHooks" ID="PyBabelProject.projectClosedHooks"></a> |
|
367 <h4>PyBabelProject.projectClosedHooks</h4> |
|
368 <b>projectClosedHooks</b>(<i></i>) |
|
369 |
|
370 <p> |
|
371 Public method to remove our hook methods. |
|
372 </p> |
|
373 <a NAME="PyBabelProject.projectOpenedHooks" ID="PyBabelProject.projectOpenedHooks"></a> |
|
374 <h4>PyBabelProject.projectOpenedHooks</h4> |
|
375 <b>projectOpenedHooks</b>(<i></i>) |
|
376 |
|
377 <p> |
|
378 Public method to add our hook methods. |
|
379 </p> |
|
380 <a NAME="PyBabelProject.registerOpenHook" ID="PyBabelProject.registerOpenHook"></a> |
|
381 <h4>PyBabelProject.registerOpenHook</h4> |
|
382 <b>registerOpenHook</b>(<i></i>) |
|
383 |
|
384 <p> |
|
385 Public method to register the open hook to open a translations file |
|
386 in a translations editor. |
|
387 </p> |
|
388 <a NAME="PyBabelProject.updateCatalogs" ID="PyBabelProject.updateCatalogs"></a> |
|
389 <h4>PyBabelProject.updateCatalogs</h4> |
|
390 <b>updateCatalogs</b>(<i>filenames, withObsolete=False</i>) |
|
391 |
|
392 <p> |
|
393 Public method to update the message catalogs. |
|
394 </p> |
|
395 <dl> |
|
396 |
|
397 <dt><i>filenames</i> (list of str)</dt> |
|
398 <dd> |
|
399 list of filenames (not used) |
|
400 </dd> |
|
401 <dt><i>withObsolete</i> (bool)</dt> |
|
402 <dd> |
|
403 flag indicating to keep obsolete translations |
|
404 </dd> |
|
405 </dl> |
|
406 <a NAME="PyBabelProject.updateCatalogsObsolete" ID="PyBabelProject.updateCatalogsObsolete"></a> |
|
407 <h4>PyBabelProject.updateCatalogsObsolete</h4> |
|
408 <b>updateCatalogsObsolete</b>(<i>filenames</i>) |
|
409 |
|
410 <p> |
|
411 Public method to update the message catalogs keeping obsolete |
|
412 translations. |
|
413 </p> |
|
414 <dl> |
|
415 |
|
416 <dt><i>filenames</i> (list of str)</dt> |
|
417 <dd> |
|
418 list of filenames (not used) |
|
419 </dd> |
|
420 </dl> |
|
421 <a NAME="PyBabelProject.updateSelectedCatalogs" ID="PyBabelProject.updateSelectedCatalogs"></a> |
|
422 <h4>PyBabelProject.updateSelectedCatalogs</h4> |
|
423 <b>updateSelectedCatalogs</b>(<i>filenames, withObsolete=False</i>) |
|
424 |
|
425 <p> |
|
426 Public method to update the selected message catalogs. |
|
427 </p> |
|
428 <dl> |
|
429 |
|
430 <dt><i>filenames</i> (list of str)</dt> |
|
431 <dd> |
|
432 list of filenames |
|
433 </dd> |
|
434 <dt><i>withObsolete</i> (bool)</dt> |
|
435 <dd> |
|
436 flag indicating to keep obsolete translations |
|
437 </dd> |
|
438 </dl> |
|
439 <a NAME="PyBabelProject.updateSelectedCatalogsObsolete" ID="PyBabelProject.updateSelectedCatalogsObsolete"></a> |
|
440 <h4>PyBabelProject.updateSelectedCatalogsObsolete</h4> |
|
441 <b>updateSelectedCatalogsObsolete</b>(<i>filenames</i>) |
|
442 |
|
443 <p> |
|
444 Public method to update the message catalogs keeping obsolete |
|
445 translations. |
|
446 </p> |
|
447 <dl> |
|
448 |
|
449 <dt><i>filenames</i> (list of str)</dt> |
|
450 <dd> |
|
451 list of filenames (not used) |
|
452 </dd> |
|
453 </dl> |
|
454 <div align="right"><a href="#top">Up</a></div> |
|
455 <hr /> |
|
456 </body></html> |