argparse模块"自动生成帮助和使用消息"。我可以为论点提供非英语名称,并提供非英语帮助文本;但是帮助输出变成了至少两种语言的混合,因为像usage
、positional arguments
、optional arguments
和show this help message and exit
这样的术语是用英语自动生成的。
如何用翻译替换此英文输出?
最好,我想在脚本中提供翻译,这样无论脚本在哪里启动,它都会生成相同的输出。
编辑:根据Jon Eric的回答,下面是他的解决方案示例:
import gettext
def Übersetzung(Text):
Text = Text.replace("usage", "Verwendung")
Text = Text.replace("show this help message and exit",
"zeige diese Hilfe an und tue nichts weiteres")
Text = Text.replace("error:", "Fehler:")
Text = Text.replace("the following arguments are required:",
"Die folgenden Argumente müssen angegeben werden:")
return Text
gettext.gettext = Übersetzung
import argparse
Parser = argparse.ArgumentParser()
Parser.add_argument("Eingabe")
Argumente = Parser.parse_args()
print(Argumente.Eingabe)
保存为Beispiel.py
会向python3 Beispiel.py -h
提供以下帮助输出:
Verwendung: Beispiel.py [-h] Eingabe
positional arguments:
Eingabe
optional arguments:
-h, --help zeige diese Hilfe an und tue nichts weiteres
argparse
使用受GNU gettext启发的gettext
API。您可以使用此API以相对干净的方式集成argparse
的翻译。
为此,请在argparse
输出任何文本之前(但可能在import argparse
之后)调用以下代码:
import gettext
# Use values that suit your project instead of 'argparse' and 'path/to/locale'
gettext.bindtextdomain('argparse', 'path/to/locale')
gettext.textdomain('argparse')
为了使此解决方案发挥作用,argparse
的翻译必须位于path/to/locale/ll/LC_MESSAGES/argparse.mo
,其中ll
是当前语言的代码(例如de
;例如可以通过设置环境变量LANGUAGE
进行配置)。
如何生成.mo
文件
pygettext --default-domain=argparse /usr/local/lib/python3.5/argparse.py
- 使用
argparse.py
的实际位置 - 创建文件
argparse.pot
- 使用
cp argparse.pot argparse-ll.po
- 使用实际的语言代码而不是
ll
- 使用实际的语言代码而不是
- 填写
argparse-ll.po
中缺失的翻译字符串 msgfmt argparse-ll.po -o locale/ll/LC_MESSAGES/argparse.mo
有关创建.mo
文件的详细信息,请参阅gettext
文档。
我已在argparse
捷克语译本的README.md中详细发布了这些说明。
单向,来自Peter Otten的这篇文章:
我对gettext了解不多,但以下内容表明argparse中的字符串被正确包装:
$ cat localize_argparse.py import gettext def my_gettext(s): return s.upper() gettext.gettext = my_gettext import argparse if __name__ == "__main__": parser = argparse.ArgumentParser() parser.add_argument("-V", action="version") args = parser.parse_args() $ python localize_argparse.py -h USAGE: localize_argparse.py [-h] [-V] OPTIONAL ARGUMENTS: -h, --help SHOW THIS HELP MESSAGE AND EXIT -V show program's version number and exit
"-V"选项的解决方法是添加帮助消息显式
parser.add_argument("-V", ..., help=_("show..."))
你仍然需要自己提供所有的翻译。
这里有一个法语翻译的解决方案,其中创建一个转换dict,保存遇到的英语关键字的翻译
def convertArgparseMessages(s):
subDict =
{'positional arguments':'Arguments positionnels',
'optional arguments':'Arguments optionnels',
'show this help message and exit':'Affiche ce message et quitte'}
if s in subDict:
s = subDict[s]
return s
gettext.gettext = convertArgparseMessages
import argparse
这里有一个Python模块,用于翻译argparse发出的所有消息。它旨在快速而肮脏地翻译成另一种语言(在我的情况下是法语,但可以根据自己的语言进行调整)。要获得更具工业性的多语言方法,请查看Filip Bartek的优秀解决方案。
"""
This module is like argparse but in french.
Import it and use it like you would use argparse.
DIRECTIVES:
First copy-paste this code in a separate new file named french_argparse.py
Put this new file beside your main.py file in the same top project folder.
Then in the main.py file, import it like this:
>>> import french_argparse as argparse
"""
import gettext
#################################################################################################################
# The following translations are in French, but feel free to replace them with your own
# Many messages are even not translated, because they seems to be more intended for the programmer than the user.
# Phrases were extracted from the code at (https://github.com/python/cpython/blob/master/Lib/argparse.py)
# On October 2019
#################################################################################################################
__TRANSLATIONS = {
'ambiguous option: %(option)s could match %(matches)s': 'option ambiguë: %(option)s parmi %(matches)s',
'argument "-" with mode %r': 'argument "-" en mode %r',
'cannot merge actions - two groups are named %r': 'cannot merge actions - two groups are named %r',
"can't open '%(filename)s': %(error)s": "can't open '%(filename)s': %(error)s",
'dest= is required for options like %r': 'dest= is required for options like %r',
'expected at least one argument': 'au moins un argument est attendu',
'expected at most one argument': 'au plus un argument est attendu',
'expected one argument': 'un argument est nécessaire',
'ignored explicit argument %r': 'ignored explicit argument %r',
'invalid choice: %(value)r (choose from %(choices)s)': 'choix invalide: %(value)r (parmi %(choices)s)',
'invalid conflict_resolution value: %r': 'invalid conflict_resolution value: %r',
'invalid option string %(option)r: must start with a character %(prefix_chars)r':
'invalid option string %(option)r: must start with a character %(prefix_chars)r',
'invalid %(type)s value: %(value)r': 'valeur invalide de type %(type)s: %(value)r',
'mutually exclusive arguments must be optional': 'mutually exclusive arguments must be optional',
'not allowed with argument %s': "pas permis avec l'argument %s",
'one of the arguments %s is required': 'au moins un argument requis parmi %s',
'optional arguments': 'arguments optionnels',
'positional arguments': 'arguments positionnels',
"'required' is an invalid argument for positionals": "'required' is an invalid argument for positionals",
'show this help message and exit': 'afficher ce message et quitter',
'unrecognized arguments: %s': 'argument non reconnu: %s',
'unknown parser %(parser_name)r (choices: %(choices)s)': 'unknown parser %(parser_name)r (choices: %(choices)s)',
'usage: ': 'usage: ',
'%(prog)s: error: %(message)sn': '%(prog)s: erreur: %(message)sn',
'%r is not callable': '%r is not callable',
}
gettext.gettext = lambda text: __TRANSLATIONS[text] or text
##############################################################################
# Now import all argparse functionalities inside this module.
#
# NB Many linters don't like the following line of code so we have disabled
# warnings for pylint, flake8 and PyCharm
##############################################################################
# pylint: disable=all
# noinspection PyUnresolvedReferences
from argparse import * # noqa
我也遇到过类似的问题。几乎所有的消息都将按照第5章中的描述进行正确翻译,但不包括添加了parser.add_argument()
的帮助消息。您可以通过对argparse使用非基于类的gettext
,对应用程序使用基于类的gettext
来解决此问题。在中查看app3.pyhttps://github.com/jmo3300/py01_i18n_01