Application Settings¶
项目的配置项在 conf/<proj>.py 文件中定义。 针对不同运行环境可以通过指定profile实现项目配置的切换,详见 Multiple Profiles 。
Uppercase Settings¶
定义的uppercase形式的配置项,如 SQLALCHEMY_DATABASE_URI
,会被认为是Flask相关的配置项,并在init app之前自动注入到 app.config
中。
Getting Settings¶
我们可以通过如下方式获取项目配置:
from guniflask.config import settings
在 settings
中存放着项目所有的配置项, settings
是一个实现了 MutableMapping
接口的对象。
我们可以通过 setings['key']
的方式获取配置项 key
的属性值,如果 key
不存在则返回 None
。
Built-in Settings¶
内置的配置项会在加载配置文件前自动填充。
home¶
项目的根目录。
app_name¶
运行的应用的名称,可以通过环境变量 GUNIFLASK_APP_NAME
指定运行的应用。
active_profiles¶
Default:
None
指定激活哪些profile。
可以通过环境变量 GUNIFLASK_ACTIVE_PROFILES
进行设置,或通过 debug/start
命令的 -p
选项进行设置。
有关使用profile区别运行环境并加载不同配置的详细信息请参考 Multiple Profiles 。
debug¶
Default:
None
是否为debug模式。
可以通过环境变量 GUNIFLASK_DEBUG
进行设置,在执行 debug
命令会自动设置。
host¶
应用运行时绑定的地址。
port¶
应用运行时绑定的端口。
ip_address¶
应用所在的主机的IP地址。
Settings to Configure the Built-in Features¶
我们在名为 guniflask
的dict对象下配置guniflask提供的内置功能。
可用的配置项包括:
cors¶
跨域相关配置。
table2model_dest¶
Default:
'<proj>/models'
配置table2model生成结果存储的模块路径,路径为相对于项目根目录的相对路径。
默认存储在项目根模块下的 models
模块中。