如何使用SQLAlchemy设置Flask应用程序进行测试?

时间:2011-02-17 06:23:58

标签: python unit-testing testing sqlalchemy flask

Flask中的常见做法就是这样开始:

from flask import Flask
from flaskext.sqlalchemy import SQLAlchemy
app = Flask(__name__)
SQLALCHEMY_DATABASE_URI = 'something'
app.config.from_object(__name__)
db = SQLAlchemy(app)

然后在任何地方导入并使用appdb。但是当你像这样创建db时,它会从应用程序中获取配置,并且似乎一旦发生这种配置就不会被覆盖。 Flask网站上有一些关于制作应用程序工厂的页面,但是如果我这样做的话,我还不清楚如何在任何地方仍然使用appdb

如何编写脚本以使用其他数据库测试Flask应用程序?我应该如何构建我的应用程序以使其成为可能?我是否必须使用module s?

3 个答案:

答案 0 :(得分:11)

您使用环境变量的直觉是正确的。但是,使用错误的数据库运行单元测试存在一些危险。此外,您可能不希望connect_db对每个请求以及您想要使用的任何位置db。您可以使用显式设置的config目录和环境变量。这是迄今为止我提出的最好的。

run.py
shell.py

config/__init__.py
config/test.py
config/postgres.py
...

main/__init__.py
main/someapp/__init__.py
main/someapp/models.py

...
main/tests/__init__.py
main/tests/testutils.py

所以,配置文件可能是:

# config/test.py
SQLALCHEMY_DATABASE_URI = "sqlite://"

# config/postgres.py
SQLALCHEMY_DATABASE_URI = 'postgresql://user:pw@localhost/somedb'

所以,我可以在我的基础TestCase中显式设置db:

import os
from flask.ext.testing import TestCase

os.environ["DIAG_CONFIG_MODULE"] = "config.test"
from main import app, db


class SQLAlchemyTest(TestCase):

    def create_app(self):
        return app

    def setUp(self):
        db.create_all()

    def tearDown(self):
        db.session.remove()
        db.drop_all()

然后,main/__init__.py,对我来说:

import os

from flask import Flask, render_template, g
from flask.ext.sqlalchemy import SQLAlchemy

# by default, let's use a DB we don't care about
# but, we can override if we want
config_obj = os.environ.get("DIAG_CONFIG_MODULE", "config.test")
app = Flask(__name__)
app.config.from_object(config_obj)
db = SQLAlchemy(app)

@app.before_request
def before_request():
    g.db = db
    g.app = app

# ...
@app.route('/', methods=['GET'])
def get():
    return render_template('home.html')
# ...    
from main.someapp.api import mod as someappmod
app.register_blueprint(someappmod)

然后,在其他文件中,我知道我想要运行什么配置,可能是:

# run.py
import os
os.environ["DIAG_CONFIG_MODULE"] = "config.postgres"
from main import app
app.run(debug=True)

# shell.py
import os
os.environ["DIAG_CONFIG_MODULE"] = "config.postgres"

from main import app, db
from main.symdiag.models import *
from main.auth.models import *
print sorted(k for k in locals().keys() if not k.startswith("_"))
import IPython
IPython.embed()

也许..目前为止最好:P。

答案 1 :(得分:6)

您不希望在导入时连接到db。继续在导入时配置您的应用程序,因为您可以在尝试测试或运行应用程序之前始终调整测试中的配置。在下面的示例中,您将在使用应用程序配置的某些函数后面建立数据库连接,因此在单元测试中,您实际上可以将数据库连接更改为指向其他文件,然后继续并在设置中明确连接。

假设你有一个包含myapp.py的myapp包,它看起来像是:

# myapp/myapp.py
from __future__ import with_statement
from sqlite3 import dbapi2 as sqlite3
from contextlib import closing
from flask import Flask, request, session, g, redirect, url_for, abort, \
     render_template, flash

# configuration
DATABASE = '/tmp/flaskr.db'
DEBUG = True
SECRET_KEY = 'development key'
USERNAME = 'admin'
PASSWORD = 'default'

# create our little application :)
app = Flask(__name__)
app.config.from_object(__name__)
app.config.from_envvar('MYAPP_SETTINGS', silent=True)

def connect_db():
    """Returns a new connection to the database."""
    return sqlite3.connect(app.config['DATABASE'])


def init_db():
    """Creates the database tables."""
    with closing(connect_db()) as db:
        with app.open_resource('schema.sql') as f:
            db.cursor().executescript(f.read())
        db.commit()


@app.before_request
def before_request():
    """Make sure we are connected to the database each request."""
    g.db = connect_db()


@app.after_request
def after_request(response):
    """Closes the database again at the end of the request."""
    g.db.close()
    return response

@app.route('/')
def show_entries():
    cur = g.db.execute('select title, text from entries order by id desc')
    entries = [dict(title=row[0], text=row[1]) for row in cur.fetchall()]
    return render_template('show_entries.html', entries=entries)

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

您的测试文件myapp / test_myapp.py将如下所示:

import os
import myapp
import unittest
import tempfile

class MyappTestCase(unittest.TestCase):

    def setUp(self):
        self.db_fd, myapp.app.config['DATABASE'] = tempfile.mkstemp()
        self.app = myapp.app.test_client()
        myapp.init_db()

    def tearDown(self):
        os.close(self.db_fd)
        os.unlink(myapp.app.config['DATABASE'])

    def test_empty_db(self):
        rv = self.app.get('/')
        assert 'No entries here so far' in rv.data

当然,如果你想使用SQLAlchemy,你必须适当地更新connect_db和init_db函数,但希望你能理解。

答案 2 :(得分:3)

首先,您不是直接在脚本中实例化Flask应用,而是使用application factory。这意味着您创建一个将配置文件作为参数的函数,并返回实例化的应用程序对象。然后,创建不带参数的全局SQLAlchemy对象,并在创建应用程序as explained here时对其进行配置。

db = SQLAlchemy()

def create_app(configfile):
    app = Flask(__name__)

    app.config.from_pyfile(config, silent=True)
    db.init_app(app)

    # create routes, etc.

    return app

要运行该应用,您只需执行以下操作:

app = create_app('config.py')
app.run()

要运行单元测试,您可以执行以下操作:

class Test(TestCase):
    def setUp(self):
        # init test database, etc.
        app = create_app('test_config.py')
        self.app = app.test_client()
    def tearDown(self):
        # delete test database, etc.

就我而言,我直接使用SQLAlchemy和scoped_session而不是Flask-SQLAlchemy。 我做了同样的事,但是Lazy SQLAlchemy setup