flask源码笔记：三，app.py模块（1）——导入对象

通过wc命令我们可以得知，app.py文件有1842行，所以这里就不一次性全部贴出来了。


(venv)[root@10-9-21-98 flask]# wc -l app.py
1842 app.py


查看模块描述：
"""
    flask.app
    ~~~~~~~~~


    This module implements the central WSGI application object.


    :copyright: (c) 2011 by Armin Ronacher.
    :license: BSD, see LICENSE for more details.
"""


可以得知：本模块就是flask框架产生WSGI应用的核心模块。


模块的前部分，仍然是对库和模块的导入，为了节约篇幅，我们对其直接后附分析
import os                                                                                            系统操作库
import sys                                                                                            环境操作库
from threading import Lock                                                               线程锁，用于避免竞争
from datetime import timedelta                         代表两个时间之间的的时间差，两个date或datetime对象相减时可以返回一个timedelta对象。                            
from itertools import chain                                 可以把一组迭代对象串联起来，形成一个更大的迭代器
from functools import update_wrapper            是wraps的主要功能提供者，它负责考贝原函数的属性，默认是：'__module__', '__name__', '__doc__'， '__dict__'。


from werkzeug.datastructures import ImmutableDict       字面理解为一个产生不可变字典的工厂类
from werkzeug.routing import Map, Rule, RequestRedirect, BuildError           制作URL路由的组件
from werkzeug.exceptions import HTTPException, InternalServerError, \
     MethodNotAllowed, BadRequest                                                                 异常处理机制      


from .helpers import _PackageBoundObject, url_for, get_flashed_messages, \
     locked_cached_property, _endpoint_from_view_func, find_package           各种辅助函数
from . import json                                                                                                  json解析
from .wrappers import Request, Response                                                         请求工厂和相应工厂  
from .config import ConfigAttribute, Config                                                      配置文件工厂
from .ctx import RequestContext, AppContext, _AppCtxGlobals                       上下文管理器
from .globals import _request_ctx_stack, request, session, g                               全局和局部变量
from .sessions import SecureCookieSessionInterface                                         会话接口
from .module import blueprint_is_module                                                            判定蓝本的函数
from .templating import DispatchingJinjaLoader, Environment, \
     _default_template_ctx_processor                                                                        前端模板的全局环境变量和默认模板
from .signals import request_started, request_finished, got_request_exception, \
     request_tearing_down, appcontext_tearing_down                                            各种信号函数
from ._compat import reraise, string_types, text_type, integer_types                    暂且理解为自定义的数据类型


以上导入的对象，各自都实现了一些细节处理，而本模块的功能，就是利用这些功能组合起来，形成一个整合的对象。


接下来，是生成一个线程锁对象
# a lock used for logger initialization
_logger_lock = Lock()
注释说明了，是用于日志的初始化


def _make_timedelta(value):
    if not isinstance(value, timedelta):
    return timedelta(seconds=value)
    return value
该函数是一个私有的，将秒转换成timedelta对象的函数。


def setupmethod(f):
"""Wraps a method so that it performs a check in debug mode if the
    first request was already handled.
    """
    def wrapper_func(self, *args, **kwargs):
        if self.debug and self._got_first_request:
            raise AssertionError('A setup function was called after the '
                'first request was handled.  This usually indicates a bug '
                'in the application where a module was not imported '
                'and decorators or other functionality was called too late.\n'
                'To fix this make sure to import all your view modules, '
                'database models and everything related at a central place '
                'before the application starts serving requests.')
        return f(self, *args, **kwargs)
    return update_wrapper(wrapper_func, f)
该对象是一个装饰器。目的是校验Flask实例是否开启了debug模式并且获取第一个请求（从字面理解），如果是这样则报错。