Skip to content

Latest commit

 

History

History
23 lines (15 loc) · 1.62 KB

options.md

File metadata and controls

23 lines (15 loc) · 1.62 KB

options

Desc

tornado.options模块负责Tornado参数的解析,包括命令行参数和配置文件参数解析。

Notices

命令行

根据tornado.options.parse_command_line函数的实现,命令参数的解析具有以下规范:

  1. 命令行参数只支持长选项,即--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

  2. 命令行参数支持GNU --(参考资料)。--会终止命令行参数的解析,并且在--之后的所有参数都不会被当作参数被解析,即使这些参数是合法的格式。

  3. 从tornado 4.3开始,默认tornado支持的参数名中dash符号"-"以及underscore符号"_"是可以互换的,也就是说配置了"--long-option=value",可以在程序中使用"long_option"的格式引用到"long-option"选项的值。tornado.options模块的注释解释dash符号主要用在命令行上,但是underscore符号主要用在配置文件中。

  4. 在命令行中设置boolean类型的参数为TrueFalse

    • 指定为False的方式:--boolean-option=False|--boolean-option=0|--boolean-option=f
    • 指定为True的方式:--boolean-option|--boolean-option=[除了"false", "0", "f"(不去分大小写)之外的所有组合]

配置文件