Python.tornado.2.tornado.options

記錄Tornado-4.0.2源碼的閱讀，學習，分析

options.py

1. imports 部分

1.1 __future__

1 from __future__ import absolute_import, division, print_function, with_statement

future_statement 即：from __futuren import XXX. 參見 XiaoKL學Python（C）__future__

1.2 other imports from Python Library

1 import datetime
2 import numbers
3 import re
4 import sys
5 import os
6 import textwrap

1.3 other imports from tornado

1 from tornado.escape import _unicode
2 from tornado.log import define_logging_options
3 from tornado import stack_context
4 from tornado.util import basestring_type, exec_in

 

2. 定義的類

2.1 OptionParser類 

該類負責解析命令行的Option, 每一個option被抽象爲類_Option的對象。

2.2 _Option類

表明命令行上的每一個option，該類爲內部類。

2.3 全局的OptionParser對象

定義了一個全局的OptionParser對象。options.py提供的接口都是在該對象上進行操做的。

末尾調用瞭如下接口來將log相關的option添加到options.py模塊中。

1 define_logging_options(options)

3. options.py對外提供的接口

[Todo]

3.1 define

1 def define(name, default=None, type=None, help=None, metavar=None,
2            multiple=False, group=None, callback=None)

 

3.2 parse_command_line

1 def parse_config_file(path, final=True)

 

 

---

Learn From options.py

1. sys模塊

import sys

https://docs.python.org/2/library/sys.html?highlight=sys#module-sys

sys._getframe([depth])

"Return a frame object from the call stack. If optional integer depth is given, return the frame

object that many calls below the top of the stack. If that is deeper than the call stack, ValueError 

is raised. The default fordepth is zero, returning the frame at the top of the call stack."

在options.py中的使用，在OptionParser類的define方法的實現中：

1         frame = sys._getframe(0)

  

2. inspect 模塊

https://docs.python.org/2/library/inspect.html

"The inspect module provides several useful functions to help get information about live

objects such as modules, classes, methods, functions, tracebacks, frame objects, and code objects. "

該模塊中包含 frame 類型(即: sys._getframe() 返回值的類型 )的說明。

 

3. unittest.mock.patch

mock 模塊

Python中的單元測試。

4. 不瞭解的語法

4.1 return xxxx if yyyy else zzzz  

1     def value(self):
2         return self.default if self._value is _Option.UNSET else self._value

 4.2 xxx for yyy, zzz in ttt

1     _TIMEDELTA_ABBREV_DICT = dict(
2         (abbrev, full) for full, abbrevs in _TIMEDELTA_ABBREVS
3         for abbrev in abbrevs)

4.3 正則表達式

1     _FLOAT_PATTERN = r'[-+]?(?:\d+(?:\.\d*)?|\.\d+)(?:[eE][-+]?\d+)?'

 

 

---

 

Reference

1. http://www.tornadoweb.org/en/stable/options.html