Flask蓝本（Blueprint）

一、动态配置Flask app

在使用单个文件开发Flask应用程序时，由于Flask对象app是在全局作用域中创建的，在运行这个全局文件脚本时，app就已经创建，所以此时修改app的配置是不会生效的。为了解决这个问题可以把app的创建移到可显式调用的工厂函数中，即延迟创建app实例。

工厂函数：app/__init__.py

from flask import Flask, render_template
from flask_sqlalchemy import SQLAlchemy
from flask_wtf.csrf import CSRFProtectfrom config import configdb = SQLAlchemy()
csrf = CSRFProtect()# 创建Flask实例,注册第三方扩展，调用config.init_app初始化
def create_app(config_name):app = Flask(__name__)app.config.from_object(config[config_name])config[config_name].init_app(app)db.init_app(app)   # 注册第三方扩展csrf.init_app(app)return app  # 返回app实例

此时调用create_app()即可动态传入config_name参数实现动态配置。

二、使用蓝本

使用工厂函数创建app实例可以解决了动态配置的问题，但是程序路由应该如何配置呢？我们在使用单个文件开发Flask程序时，在全局作用域创建了app实例，直接使用app.route就可配置路由，而现在app实例的创建已经移到工厂函数中进行了，只有调用工厂函数create_app后才能使用app实例，然而我们的路由函数在编写程序时已经定义好了，也就是说在编写路由函数时是无法获取到app实例的，也就无法定义路由配置。通用的所有需要在编码时使用app实例的配置此时都无法使用。

为了解决这个问题flask提供了蓝本。
蓝本：app/main/__init__.py

from flask import Blueprintmain = Blueprint('main', __name__)  # 创建蓝本from . import  views   # 在views定义程序的路由

在views中定义的程序路由只有在蓝本注册到app实例上后才有效。

# 创建Flask实例,注册第三方扩展，调用config.init_app初始化
def create_app(config_name):app = Flask(__name__)app.config.from_object(config[config_name])config[config_name].init_app(app)db.init_app(app)csrf.init_app(app)from .main import main as main_blueprint  # 导入蓝本app.register_blueprint(main_blueprint)  # 注册蓝本return app

完整的（app/__init__.py）

from flask import Flask, render_template
from flask_sqlalchemy import SQLAlchemy
from flask_wtf.csrf import CSRFProtectfrom config import configdb = SQLAlchemy()
csrf = CSRFProtect()# 创建Flask实例,注册第三方扩展，调用config.init_app初始化
def create_app(config_name):app = Flask(__name__)app.config.from_object(config[config_name])config[config_name].init_app(app)db.init_app(app)csrf.init_app(app)#注册蓝本from .main import main as main_blueprintfrom .auth import auth as auth_blueprintapp.register_blueprint(main_blueprint)app.register_blueprint(auth_blueprint, url_prefix = '/auth')return app

views.py

from datetime import datetimefrom flask import render_template, session, redirect, url_forfrom . import main # 导入蓝本@main.route('/home', methods = ['GET', 'POST']) # 定义路由
def index():return render_template('welcome.html')

三、定义程序启动脚本

manage.py

import osfrom flask_script import Manager, Shell
from flask_migrate import Migrate, MigrateCommandfrom app import create_app
from app import dbapp = create_app(os.getenv('FLASK_CONFIG') or 'default')
manager = Manager(app)
migrate = Migrate(app, db)def make_shell_context():return dict(app=app, db=db)manager.add_command('shell', Shell( make_context = make_shell_context() ) )
manager.add_command('db', MigrateCommand)if __name__ == '__main__':manager.run()

在定义程序脚本时需要使用Flask-Script和Flask-Migrate包。运行python manage.py即可启动程序。

四、完整的项目结构

|-- myproject|-- config.py|-- flask-env.yml|-- manage.py|-- app|   |-- models.py|   |-- __init__.py   # 创建app实例的工厂函数|   |-- auth  # auth蓝本|   |   |-- forms.py|   |   |-- views.py|   |   |-- __init__.py|   |   |-- templates|   |-- main   # main蓝本|   |   |-- errors.py|   |   |-- forms.py|   |   |-- views.py|   |   |-- __init__.py|   |-- static|   |   |-- css|   |   |-- image|   |   |-- js|   |-- templates|-- migrations|-- tests|   |-- __init__.py|-- venv

五、动态配置类

config.py

import os
basedir = os.path.abspath(os.path.dirname(__file__))# 通用配置
class Config:WTF_CSRF_SECRET_KEY = os.environ.get('WTF_CSRF_SECRET_KEY') or 'ao blog csrf key'SECRET_KEY = os.environ.get('SECRET_KEY') or 'ao blog session key'SQLALCHEMY_COMMIT_ON_TEARDOWN = TrueSQLALCHEMY_TRACK_MODIFICATIONS = False# 初始化Flask实例，对当前环境的配置初始化@staticmethoddef init_app(app):app.config['SECRET_KEY'] = SQLALCHEMY_COMMIT_ON_TEARDOWNapp.config['SQLALCHEMY_COMMIT_ON_TEARDOWN'] = SQLALCHEMY_COMMIT_ON_TEARDOWNapp.config['SQLALCHEMY_TRACK_MODIFICATIONS'] = SQLALCHEMY_COMMIT_ON_TEARDOWNapp.config['WTF_CSRF_SECRET_KEY'] = SQLALCHEMY_COMMIT_ON_TEARDOWN# 开发环境配置
class DevelopmentConfig(Config):DEBUG = True# SQLALCHEMY_TRACK_MODIF = TrueSQLALCHEMY_DATABASE_URI = os.environ.get('DEV_DATABASE_URL') or \'sqlite:///' + os.path.join(basedir, 'data-dev.sqlite')class TestingConfig(Config):TESTING = TrueSQLALCHEMY_DATABASE_URI = os.environ.get('DEV_DATABASE_URL') or \'sqlite:///' + os.path.join(basedir, 'data-dev.sqlite')class ProductionConfig(Config):SQLALCHEMY_DATABASE_URI = os.environ.get('DEV_DATABASE_URL') or \'sqlite:///' + os.path.join(basedir, 'data-dev.sqlite')config = {'dev': DevelopmentConfig,'test': TestingConfig,'prod': ProductionConfig,'default': DevelopmentConfig
}