db.init_appの初期化処理の処理の流れ、及び仕組みについて

Question

一回目の起動時のみにテーブル作成及びデフォルト値のデータ挿入を実行させるように書きたいです。
下記は、サンプルですが、db.init_appの関数定義がなく、どう書くものでしょうか？db.init_app(app)の意味が気になっています。なぜ、わざわざcreate_app関数を定義してappをreturnさせて別で呼び出す必要があるのでしょうか？そもそも、これを初期化処理と読んでいいものでしょうか？

初期化処理は、だれもが書くような内容だと思うのでflaskでかかれたサンプルをご存知でしたら教えていただけると助かります。

run.py

from app import create_app

if __name__ == "__main__":
    app = create_app()
    app.run()

app/init.py

from flask import Flask
from flask_debugtoolbar import DebugToolbarExtension
from flask.ext.sqlalchemy import SQLAlchemy # Import SQLAlchemy
from flask.ext.mongoengine import MongoEngine # Import Mongoengine
from flask.ext.admin import Admin
from app import config

# app setup
db = SQLAlchemy()
mongodb = MongoEngine()
admin = Admin()
toolbar = DebugToolbarExtension()

def create_app():

    app = Flask()
    app.config.config_from_object(config)

    #Initializing
    db.init_app(app)
    mongodb.init_app(app)
    admin.init_app(app)
    toolbar.init_app(app)

   # Import a module
    from app.module1.controllers import mod_app

    # Register blueprint(s)
    app.register_blueprint(mod_app)

    # Build the database:
    # This will create the database file using SQLAlchemy
    db.create_all()

    return app

引用元：
https://qiita.com/divider_kuro/items/c74514af9ea89f1b9793

Answer 1

主に設定 app.config を操作しているみたいですね。
自分も気になっていたので、該当のソースコードを引っ張ってきました。

• flask-sqlalchemy/flask_sqlalchemy/init.py

flask.ext.sqlalchemy は deprecated

ちなみに flask.ext.sqlalchemy は deprecated とのことで、別の箇所から引っ張っています。

Importing flask.ext.sqlalchemy is deprecated, use flask_sqlalchemy instead.
↓
flask.ext.sqlalchemyのインポートは非推奨です。代わりにflask_sqlalchemyを使用してください。

だそうです。（エラーではなくて Warning=警告 ですね）

flaskの勉強をしていたらこういったエラーに出会いましたが、どういう内容かわかりますか？

ソースコード

class SQLAlchemy(object):

    ...

    def init_app(self, app):
        """This callback can be used to initialize an application for the
        use with this database setup.  Never use a database in the context
        of an application not initialized that way or connections will
        leak.
        
        （だいぶ意訳）
        この関数を使えば、
        このデータベースのセットアップするために、アプリケーションを初期化することができます。
        アプリケーションコンテキストの中でデータベースを使わなかった場合、
        データベース接続が漏れてしまいます。
        """
        if (
            'SQLALCHEMY_DATABASE_URI' not in app.config and
            'SQLALCHEMY_BINDS' not in app.config
        ):
            warnings.warn(
                'Neither SQLALCHEMY_DATABASE_URI nor SQLALCHEMY_BINDS is set. '
                'Defaulting SQLALCHEMY_DATABASE_URI to "sqlite:///:memory:".'
            )

        app.config.setdefault('SQLALCHEMY_DATABASE_URI', 'sqlite:///:memory:')
        app.config.setdefault('SQLALCHEMY_BINDS', None)
        app.config.setdefault('SQLALCHEMY_NATIVE_UNICODE', None)
        app.config.setdefault('SQLALCHEMY_ECHO', False)
        app.config.setdefault('SQLALCHEMY_RECORD_QUERIES', None)
        app.config.setdefault('SQLALCHEMY_POOL_SIZE', None)
        app.config.setdefault('SQLALCHEMY_POOL_TIMEOUT', None)
        app.config.setdefault('SQLALCHEMY_POOL_RECYCLE', None)
        app.config.setdefault('SQLALCHEMY_MAX_OVERFLOW', None)
        app.config.setdefault('SQLALCHEMY_COMMIT_ON_TEARDOWN', False)
        track_modifications = app.config.setdefault(
            'SQLALCHEMY_TRACK_MODIFICATIONS', None
        )

        if track_modifications is None:
            warnings.warn(FSADeprecationWarning(
                'SQLALCHEMY_TRACK_MODIFICATIONS adds significant overhead and '
                'will be disabled by default in the future.  Set it to True '
                'or False to suppress this warning.'
            ))

        app.extensions['sqlalchemy'] = _SQLAlchemyState(self)

        @app.teardown_appcontext
        def shutdown_session(response_or_exc):
            if app.config['SQLALCHEMY_COMMIT_ON_TEARDOWN']:
                if response_or_exc is None:
                    self.session.commit()

            self.session.remove()
            return response_or_exc