tornado.options模块负责Tornado参数的解析,包括命令行参数和配置文件参数解析。
根据tornado.options.parse_command_line函数的实现,命令参数的解析具有以下规范:
-
命令行参数只支持长选项,即
--long-option value或--long-option=vlaue(long options),并且长选项只支持--long-option=value的方式,不支持--long-option value的方式。如果你在程序中使用的是
--long-option value的方式,则会报错说找不到"long-option"参数对应的值:tornado.options.Error: Option 'long-option' requires a value -
命令行参数支持GNU
--(参考资料)。--会终止命令行参数的解析,并且在--之后的所有参数都不会被当作参数被解析,即使这些参数是合法的格式。 -
从tornado 4.3开始,默认tornado支持的参数名中dash符号"-"以及underscore符号"_"是可以互换的,也就是说配置了"--long-option=value",可以在程序中使用"long_option"的格式引用到"long-option"选项的值。
tornado.options模块的注释解释dash符号主要用在命令行上,但是underscore符号主要用在配置文件中。 -
在命令行中设置
boolean类型的参数为True或False。- 指定为
False的方式:--boolean-option=False|--boolean-option=0|--boolean-option=f - 指定为
True的方式:--boolean-option|--boolean-option=[除了"false", "0", "f"(不去分大小写)之外的所有组合]
- 指定为