跳到主要内容

get_flask_sqlalchemy_proxy_ver

函数源码

db: SQLAlchemyProxy[
flask_sqlalchemy_lite.SQLAlchemy, _ModelLite
] = get_flask_sqlalchemy_proxy_ver[_ModelLite](
model_class: type[_ModelLite],
app: Flask | None = None,
engine_options: Mapping[str, Any] | None = None,
session_options: Mapping[str, Any] | None = None,
)

get_flask_sqlalchemy注解为代理的版本。

该函数的用法和返回值都和get_flask_sqlalchemy全然相同。然而,该用法的第一个返回值会被刻意注解为SQLAlchemyProxy。这是为了帮助开发者了解兼容状态下的版本支持哪些功能。

别名

该函数可以按以下方式之一获取

import flask_sqlalchemy_compat as fsc


fsc.get_flask_sqlalchemy_proxy_ver
fsc.auto.get_flask_sqlalchemy_proxy_ver

参数

输入

参数类型必选
说明
model_classtype[_ModelLite]应用到整个数据库的基础 ORM 模型类型。若flask_sqlalchemy可用,该类型将会作为model_class传递给数据库扩展实例的构造函数,并用来创建扩展实例所持有的基模型类。不过,若数据库对象退回到了flask_sqlalchemy_lite提供的版本,该类型将会受到原处修改,以便其能支持flask_sqlalchemy.SQLAlchemy().Model的特性。
appFlask | None向该 Flask 应用调用init_app方法。若未指定该值,则不会调用init_app
engine_optionsMapping[str, Any] | None该配置将会在创建每个引擎时,传递给构造函数sqlalchemy.create_engine
session_optionsMapping[str, Any] | None用来配置sessionmaker的参数。
  • 其中,_ModelLitesa.orm.DeclarativeBaseTypeVar

输出

参数类型
说明
dbSQLAlchemyProxy[flask_sqlalchemy_lite.SQLAlchemy, _ModelLite]

SQLAlchemy扩展实例。在运行时,它与get_flask_sqlalchemy的返回值全然相同。

然而,该返回值永远被注解为SQLAlchemyProxy,这是为了提供flask_sqlalchemy缺位时、兼容版实例的静态注解。