flask详解--app.py （1）

一年一度秋风劲

已于 2024-04-14 08:01:42 修改

阅读量1.6k

点赞数 38

文章标签： flask python 后端

于 2024-04-12 22:05:59 首次发布

本文链接：https://blog.csdn.net/2301_79497221/article/details/137695564

版权

app.py （1）

from __future__ import annotations

import collections.abc as cabc
import os
import sys
import typing as t
import weakref
from datetime import timedelta
from inspect import iscoroutinefunction
from itertools import chain
from types import TracebackType
from urllib.parse import quote as _url_quote

import click
from werkzeug.datastructures import Headers
from werkzeug.datastructures import ImmutableDict
from werkzeug.exceptions import BadRequestKeyError
from werkzeug.exceptions import HTTPException
from werkzeug.exceptions import InternalServerError
from werkzeug.routing import BuildError
from werkzeug.routing import MapAdapter
from werkzeug.routing import RequestRedirect
from werkzeug.routing import RoutingException
from werkzeug.routing import Rule
from werkzeug.serving import is_running_from_reloader
from werkzeug.wrappers import Response as BaseResponse

这段代码主要做了一些Python模块的导入。下面我会为你详细解释每一部分：

from __future__ import annotations：
这是Python 3.7之后引入的特性，允许延迟对类型注释的解析，使得类型注释可以在循环引用等复杂场景中更加灵活地使用。
import collections.abc as cabc：
从collections.abc导入所有的抽象基类（例如Iterable, Mapping, Sequence等），并将它们命名为cabc以简化引用。
import os, sys, typing as t：
导入常用的模块：os用于与操作系统交互，sys提供了与Python解释器相关的变量和函数，typing（这里重命名为t）提供了类型提示的支持。
import weakref：
导入weakref模块，它允许创建对对象的弱引用，即不会增加对象的引用计数。
from datetime import timedelta：
从datetime模块导入timedelta类，它表示两个日期或时间之间的差。
from inspect import iscoroutinefunction：
从inspect模块导入iscoroutinefunction函数，用于检查一个对象是否是协程函数。
from itertools import chain：
从itertools模块导入chain函数，它可以将多个迭代器链接成一个。
from types import TracebackType：
从types模块导入TracebackType，它表示Python的异常回溯类型。
from urllib.parse import quote as _url_quote：
从urllib.parse模块导入quote函数，并将其重命名为_url_quote，用于URL编码。
import click：
导入click模块，这是一个用于创建命令行接口的Python库。
从werkzeug导入多个模块和类：
- Headers：用于表示HTTP头信息的类。
- ImmutableDict：不可变的字典类。
- BadRequestKeyError, HTTPException, InternalServerError：这些都是werkzeug提供的异常类。
- BuildError, MapAdapter, RequestRedirect, RoutingException, Rule：这些都是与路由相关的类和异常。
- BaseResponse：表示HTTP响应的基类。
- is_running_from_reloader：一个函数，用于检查应用是否正在从Werkzeug的reloader中运行。

总的来说，这段代码主要导入了一些Python的标准库模块和一些第三方库（如click和werkzeug），为接下来的代码提供了所需的功能和工具。特别是werkzeug库，它是Python Web开发中的一个重要库，提供了许多与Web请求、响应和路由相关的功能。

from . import cli
from . import typing as ft
from .ctx import AppContext
from .ctx import RequestContext
from .globals import _cv_app
from .globals import _cv_request
from .globals import current_app
from .globals import g
from .globals import request
from .globals import request_ctx
from .globals import session
from .helpers import get_debug_flag
from .helpers import get_flashed_messages
from .helpers import get_load_dotenv
from .helpers import send_from_directory
from .sansio.app import App
from .sansio.scaffold import _sentinel
from .sessions import SecureCookieSessionInterface
from .sessions import SessionInterface
from .signals import appcontext_tearing_down
from .signals import got_request_exception
from .signals import request_finished
from .signals import request_started
from .signals import request_tearing_down
from .templating import Environment
from .wrappers import Request
from .wrappers import Response

if t.TYPE_CHECKING:  # pragma: no cover
    from _typeshed.wsgi import StartResponse
    from _typeshed.wsgi import WSGIEnvironment

    from .testing import FlaskClient
    from .testing import FlaskCliRunner

这段Python代码主要做了以下几件事情：

模块导入：
- 它从当前包（. 表示当前包）中导入了一系列的模块、类和变量。这些模块、类和变量大多与Web框架的功能相关，涵盖了命令行接口（cli）、类型注解（typing）、上下文管理（ctx）、全局变量（globals）、帮助函数（helpers）、应用构建（sansio.app）、会话管理（sessions）、信号（signals）、模板环境（templating）以及请求和响应的封装（wrappers）。
类型注解与类型检查：
- if t.TYPE_CHECKING: 这段代码检查一个常量 TYPE_CHECKING 是否为真。这通常用于在类型检查期间导入额外的类型注解，但在运行时不会执行这部分代码，因为类型注解在运行时是不需要的。这是一种优化手段，可以减少运行时的开销。
- 在 TYPE_CHECKING 为真的条件下，它导入了 StartResponse 和 WSGIEnvironment，这两个都是WSGI（Web服务器网关接口）规范中定义的类型，用于Web服务器和Web应用之间的通信。
- 同时，它还导入了 FlaskClient 和 FlaskCliRunner，这两个可能是用于测试Flask应用的工具类。
typing导入的区别：
- 代码中引用的 t 是 typing 的一个别名，通常在代码的开始部分会有 import typing as t 这样的导入语句。
- 类似地，timedelta 在 _make_timedelta 函数的参数类型注解中被使用，它通常来自 datetime 模块，即 from datetime import timedelta。
- 代码中引用的 ft 也是 typing （当前目录下的）的一个别名，前面的导入命令：from . import typing as ft