File: //usr/local/ssl/bin/pygettext.pyo
m
=5Dc @ s y d k Z e i Z Wn e j
o d Z n Xe d Z d k Z d k Z d k Z d k Z d k Z d k
Z
d k Z d k Z d k
Z
d Z d g a d i t Z d Z e d Z d d Z g a d Z d
Z d Z d Z d
Z d Z d d Z d Z d f d YZ d Z e! d j o6 e e d e d h d d <e d n d S( Nc C s | S( N( t s( R ( ( t /usr/bin/pygettext.pyt <lambda> s s pygettext -- Python equivalent of xgettext(1)
Many systems (Solaris, Linux, Gnu) provide extensive tools that ease the
internationalization of C programs. Most of these tools are independent of
the programming language and can be used from within Python programs.
Martin von Loewis' work[1] helps considerably in this regard.
There's one problem though; xgettext is the program that scans source code
looking for message strings, but it groks only C (or C++). Python
introduces a few wrinkles, such as dual quoting characters, triple quoted
strings, and raw strings. xgettext understands none of this.
Enter pygettext, which uses Python's standard tokenize module to scan
Python source code, generating .pot files identical to what GNU xgettext[2]
generates for C and C++ code. From there, the standard GNU tools can be
used.
A word about marking Python strings as candidates for translation. GNU
xgettext recognizes the following keywords: gettext, dgettext, dcgettext,
and gettext_noop. But those can be a lot of text to include all over your
code. C and C++ have a trick: they use the C preprocessor. Most
internationalized C source includes a #define for gettext() to _() so that
what has to be written in the source is much less. Thus these are both
translatable strings:
gettext("Translatable String")
_("Translatable String")
Python of course has no preprocessor so this doesn't work so well. Thus,
pygettext searches only for _() by default, but see the -k/--keyword flag
below for how to augment this.
[1] http://www.python.org/workshops/1997-10/proceedings/loewis.html
[2] http://www.gnu.org/software/gettext/gettext.html
NOTE: pygettext attempts to be option and feature compatible with GNU
xgettext where ever possible. However some options are still missing or are
not fully implemented. Also, xgettext's use of command line switches with
option arguments is broken, and in these cases, pygettext just defines
additional switches.
Usage: pygettext [options] inputfile ...
Options:
-a
--extract-all
Extract all strings.
-d name
--default-domain=name
Rename the default output file from messages.pot to name.pot.
-E
--escape
Replace non-ASCII characters with octal escape sequences.
-D
--docstrings
Extract module, class, method, and function docstrings. These do
not need to be wrapped in _() markers, and in fact cannot be for
Python to consider them docstrings. (See also the -X option).
-h
--help
Print this help message and exit.
-k word
--keyword=word
Keywords to look for in addition to the default set, which are:
%(DEFAULTKEYWORDS)s
You can have multiple -k flags on the command line.
-K
--no-default-keywords
Disable the default set of keywords (see above). Any keywords
explicitly added with the -k/--keyword option are still recognized.
--no-location
Do not write filename/lineno location comments.
-n
--add-location
Write filename/lineno location comments indicating where each
extracted string is found in the source. These lines appear before
each msgid. The style of comments is controlled by the -S/--style
option. This is the default.
-o filename
--output=filename
Rename the default output file from messages.pot to filename. If
filename is `-' then the output is sent to standard out.
-p dir
--output-dir=dir
Output files will be placed in directory dir.
-S stylename
--style stylename
Specify which style to use for location comments. Two styles are
supported:
Solaris # File: filename, line: line-number
GNU #: filename:line
The style name is case insensitive. GNU style is the default.
-v
--verbose
Print the names of the files being processed.
-V
--version
Print the version of pygettext and exit.
-w columns
--width=columns
Set width of output to columns.
-x filename
--exclude-file=filename
Specify a file that contains a list of strings that are not be
extracted from the input files. Each string to be excluded must
appear on a line by itself in the file.
-X filename
--no-docstrings=filename
Specify a file that contains a list of files (one per line) that
should not have their docstrings extracted. This is only useful in
conjunction with the -D option above.
If `inputfile' is -, standard input is read.
s 1.5t _s , t s # SOME DESCRIPTIVE TITLE.
# Copyright (C) YEAR ORGANIZATION
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
msgid ""
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"POT-Creation-Date: %(time)s\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=CHARSET\n"
"Content-Transfer-Encoding: ENCODING\n"
"Generated-By: pygettext.py %(version)s\n"
c C s= t i t t IJ| o t i | IJn t i | d S( N( t syst stderrt __doc__t globalst msgt exitt code( R R ( ( R t usage s c C s | o
d } n d } x^ t d D]P } d | | j o
d j n o t i t | q$ t i d | q$ Wd t t d <d t t d <d
t t d <d t t d
<d t t d <d S( Ni i i i~ s \%03os \\s \s \ts s \rs
s \ns
s \"s "( t pass_iso8859t modt ranget it escapest appendt chrt ord( R
R R ( ( R t make_escapes s
"c C sN t | } x2 t t | D] } t t | | | | <q Wt i | S( N( t listR R t lenR R R t EMPTYSTRINGt join( R R ( ( R t escape s c C s t | h d h <h S( Nt __builtins__( t evalR ( R ( ( R t safe_eval s c C s | i d } t | d j o d t | d } nw | d p | d =| d d | d <n x. t t | D] } t | | | | <qu Wd } d | i | d } | S( Ns
i t "is \n"
"s ""
"( R t splitt linesR R R R t linetermR ( R R R R! ( ( R t normalize s c C s+ d g } | D] } | | | j q ~ j S( s6 Check whether 'str' contains ANY of the chars in 'set'i N( t _[1]t sett ct str( R& R$ R# R% ( ( R t containsAny s c C s t i d pK g } t i D]) } | d t i j o | | d q$ q$ ~ d a n d | j o | i d n | i g } | D]= } t
i i | d t j o | t
i i | | q q ~ d S( s Helper for getFilesForName().t _py_exti i t CVSi N( R t has_keyR# t impt get_suffixest triplet PY_SOURCER( t namest removeR t extendt filet ost patht splitextR t dirname( R R6 R/ R2 R# R- ( ( R t _visit_pyfiles s K
c C s* | i d d } t | d j o y8 t i | d | \ } } } | o | i
n Wn t j
o d Sn X| d t i
j o t | d | g } q&d } nx y[ t i | | \ } } } | o | i
n | d t i t i
g j o
d } n Wn t j
o
d } n X| S( s Get the filesystem path for a module or a package.
Return the file system path to a file for a module, and to a directory for
a package. Return None if the name is not found, or is a builtin or
extension module.
t .i i i N( t dotted_nameR t partsR R+ t find_modulet pathlistR2 t pathnamet descriptiont closet ImportErrort Nonet
PKG_DIRECTORYt _get_modpkg_pathR. ( R9 R< R> R: R= R2 ( ( R RC s*
c C s t i i | pp t | d oA t i | } g } x! | D] } | i t
| q? W| Sn t | } | p g Sq n t i i | o$ g } t i i
| t | | Sn t i i | o | g Sn g S( s] Get a list of module files for a filename, a module or package name,
or a directory.
s *?[]N( R3 R4 t existst nameR' t globt filesR R2 R1 t getFilesForNameRC t isdirt walkR7 ( RE RG R R2 ( ( R RH C s& t
TokenEaterc B sh t Z d Z d Z d Z d Z d Z d Z d Z d d d Z
d
Z d Z RS( Nc C sF | | _ h | _ | i | _ g | _ d | _ d | _ d | _
d S( Nii ( t optionst selft _TokenEater__optionst _TokenEater__messagest _TokenEater__waitingt _TokenEater__statet _TokenEater__datat _TokenEater__linenot _TokenEater__freshmoduleRA t _TokenEater__curfile( RM RL ( ( R t __init__b s c C s | i | | | d d S( Ni ( RM RQ t ttypet tstringt stup( RM RW RX RY t etupt line( ( R t __call__k s c C s | i } | i o | i i | i o | i og | t i
j o) | i t | | d d d | _ n' | t i t i f j o
d | _ n d Sn | t i j o! | d j o | i | _ d Sq n | t i j o | | i j o | i | _ n d S( Nt isdocstringi i t classt def( R^ R_ ( RM RN t optst
docstringst nodocstringst getRU RT RW t tokenizet STRINGt _TokenEater__addentryR RX t linenot COMMENTt NLt NAMEt _TokenEater__suiteseenRQ t keywordst _TokenEater__keywordseen( RM RW RX Rg R` ( ( R t __waitingr s !
c C s1 | t i j o | d j o | i | _ n d S( Nt :( RW Rd t OPRX RM t _TokenEater__suitedocstringRQ ( RM RW RX Rg ( ( R t __suiteseen s c C so | t i j o, | i t | | d d | i | _ n0 | t i
t i t i f j o | i | _ n d S( NR] i (
RW Rd Re RM Rf R RX Rg RP RQ t NEWLINEt INDENTRh ( RM RW RX Rg ( ( R t __suitedocstring s
c C sO | t i j o/ | d j o" g | _ | | _ | i | _ n
| i
| _ d S( Nt (( RW Rd Rp RX RM RR Rg RS t _TokenEater__openseenRQ RP ( RM RW RX Rg ( ( R t
__keywordseen s
c C s | t i j oD | d j o7 | i o | i t i | i n | i | _
n | t i j o | i i t
| nt | t i t i t i t i t i g j oH t i t d h d | <d | i <d | i <IJ| i | _
n d S( Nt )s: *** %(file)s:%(lineno)s: Seen unexpected token "%(token)s"t tokenR2 Rg ( RW Rd Rp RX RM RR Rf R R RP RQ Re R R Rh Rz Rt t DEDENTRs Ri R R R RU RS ( RM RW RX Rg ( ( R t
__openseen s
+8i c C s] | d j o
| i } n | | i i j o, | i | f } | | i
i | h | <n d S( N( Rg RA RM RS R RN t toexcludeRU t entryR] RO t
setdefault( RM R Rg R] R~ ( ( R t
__addentry s
c C s | | _ d | _ d S( Ni ( t filenameRM RU RT ( RM R ( ( R t set_filename s c C s | i }
t i d } | t h d | <d t <IJh }
xX | i
i D]G \ } } | i } | i |
i t | g i | | f qN W|
i } | i x| D]} |
| } | i x| D]\ } } d } t t i | i o
d } n | i } | i |
i p n|
i |
i j oG x| D]8 \ } } h d | <d | <} | t! d | IJqJWn |
i |
i" j o d } x~ | D]v \ } } h d | <d | <} t! d
| } t% | t% | |
i& j o | | } q| | IJd | } qWt% | d j o | | IJqIn | o | d IJn | d
It' | IJ| d IJq Wq Wd S( Ns %Y-%m-%d %H:%M+%Zt timet versioni i R Rg s& # File: %(filename)s, line: %(lineno)ds #:s %(filename)s:%(lineno)di s #, docstringt msgids
msgstr ""
(( RM RN RL R t strftimet timestampt fpt
pot_headert __version__t reverseRO t itemst kt vt keyst sortR t tupleR t rkeyst rkeyt rentriesR] t reducet operatort __add__t valuest writelocationst
locationstylet SOLARISR Rg t dR t GNUt loclineR R t widthR" ( RM R R R Rg R R R R R R R] R RL R R R ( ( R t write sZ
)
(
t __name__t
__module__RV R\ RP Rk Rq Rm Rw RA Rf R R ( ( ( R RK a s
c C s yY t i t i d d d d d d d d d d
d d d
d d d d d d g \ } } Wn% t i j
o } t d | n Xd f d Y}
|
}
h d |
i
<d |
i <} x| D]\ } } | dE j o t d q | dF j o
d |
_ q | dG j o | d |
_ q | dH j o
d |
_ q | dI j o
d |
_ q | dJ j o |
i i | q | dK j o
g a q | dL j o
d |
_ q | dM j o
d |
_ q | dN j oG | i | i |
_ |
i d j o t d t d- | q[q | dO j o
| |
_ q | dP j o
| |
_ q | dQ j o
d |
_ q | dR j o t d6 t GHt i d q | dS j oD y t | |
_! Wq[t" j
o t d t d9 | q[Xq | dT j o
| |
_# q | dU j oS t$ | } z5 x. | i& } | p Pn d |
i( | d> <qWWd | i) Xq q Wt* |
i |
i i+ t |
i# om y, t$ |
i# } | i, |
_- | i) Wqt. j
o. t i/ t d? |
i# IJt i d qXn
g |
_- g } x? | D]7 } | d@ j o | i | q | i+ t1 | q W| } t2 |
} x| D] } | d@ j o, |
i o t dA GHn t i5 } d } n0 |
i o t dB | GHn t$ | } d } zt | i7 | y t8 i8 | i& | WnI t8 i9 j
o: } t i/ dC | d | | d d | d d f IJn XWd | o | i) n Xq]W|
i d@ j o t i; } d } nE |
i o" t< i= i> |
i |
i |
_ n t$ |
i dD } d } z | i? | Wd | o | i) n Xd S(V Ni s ad:DEhk:Kno:p:S:Vvw:x:X:s extract-alls default-domain=R t helps keyword=s no-default-keywordss add-locations no-locations output=s output-dir=s style=t verboseR s width=s
exclude-file=Ra s
no-docstringst Optionsc B s\ t Z d Z d Z d Z d Z g Z d Z d Z d Z e Z
d Z d Z d Z
d Z h Z RS( Ni i i R s messages.potiN ( R R R R t
extractallR Rl t outpatht outfileR R R R t excludefilenameRa Rb ( ( ( R R s t gnut solariss -hs --helpi s -as
--extract-alls -ds --default-domains .pots -Es --escapes -Ds --docstringss -ks --keywords -Ks --no-default-keywordss -ns --add-locations
--no-locations -Ss --styles Invalid value for --style: %ss -os --outputs -ps --output-dirs -vs --verboses -Vs --versions% pygettext.py (xgettext for Python) %ss -ws --widths' --width argument must be an integer: %ss -xs --exclude-files -Xs --no-docstringsis Can't read --exclude-file: %st -s Reading standard inputs
Working on %ss %s: %s, line %d, column %dt w( s -hs --help( s -as
--extract-all( s -ds --default-domain( s -Es --escape( s -Ds --docstrings( s -ks --keyword( s -Ks --no-default-keywords( s -ns --add-location( s
--no-location( s -Ss --style( s -os --output( s -ps --output-dir( s -vs --verbose( s -Vs --version( s -ws --width( s -xs --exclude-file( s -Xs --no-docstrings(@ t getoptR t argvR` t argst errorR R R RL R R t locationst optt argR R R Ra Rl R t default_keywordsR Rc t lowerR RA R R R R R
t intR t
ValueErrorR t openR t readlineR[ Rb R? R R1 t readlinesR} t IOErrorR t expandedRH RK t eaterR t stdint closepR Rd t
TokenErrort et stdoutR3 R4 R R ( R R R R R R R R R R[ R R R RL R` ( ( R t main s F
:
" t __main__u a unicode strings% *** Seen unexpected token "%(token)s"Rz t testt morethanonestring(" t fintlt gettextR R@ R R3 R+ R RF R R Rz Rd R R R R t DEFAULTKEYWORDSR R R R R R R R" R' R7 RA RC RH RK R R ( R7 R R R" R R+ R Rd R R R R RH R RF R R RK R R R RC R R' Rz R R3 ( ( R t ? sH
'