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"(不去分大小写)之外的所有组合]
- 指定为