pygettext
Extract translatable strings from Python code
TLDR
Extract translatable strings
$ pygettext [script.py]
Specify output file$ pygettext -o [messages.pot] [script.py]
Extract from directory$ pygettext -d [domain] [src/]
Include docstrings$ pygettext -D [script.py]
SYNOPSIS
pygettext [options] files...
DESCRIPTION
pygettext extracts translatable strings from Python source code. It searches for strings marked with _(), gettext(), and similar functions, creating a POT template file.Part of Python standard library.
PARAMETERS
-o, --output file
Output file name.-d, --domain name
Text domain name.-p, --output-dir dir
Output directory.-D, --docstrings
Extract docstrings.-k keyword
Additional keyword to look for.-n, --add-location
Include file:line comments.
EXAMPLES
$ # Basic extraction
pygettext -o messages.pot *.py
# From directory
pygettext -d myapp -p locale src/*.py
# Include docstrings
pygettext -D -o docs.pot module.py
# Custom keywords
pygettext -k N_ -k ngettext:1,2 app.py
pygettext -o messages.pot *.py
# From directory
pygettext -d myapp -p locale src/*.py
# Include docstrings
pygettext -D -o docs.pot module.py
# Custom keywords
pygettext -k N_ -k ngettext:1,2 app.py
MARKING STRINGS
$ from gettext import gettext as _
message = _("This will be translated")
print(_("Hello, world!"))
message = _("This will be translated")
print(_("Hello, world!"))
OUTPUT FORMAT (POT)
$ #: script.py:10
msgid "Hello, world!"
msgstr ""
msgid "Hello, world!"
msgstr ""
CAVEATS
Part of Python. For more features, use xgettext or Babel. Output is template, translators create .po files.
HISTORY
pygettext is part of Python tools for internationalization, implementing gettext extraction for Python.
