From 07361d1fd6b4531e422e2593c91b47bc6bf88993 Mon Sep 17 00:00:00 2001 From: Tim Graham Date: Fri, 2 Nov 2012 16:33:07 -0400 Subject: [PATCH] Fixed #19167 - Added a warning regarding module-level database queries Thanks Daniele Procida for the patch. --- docs/topics/testing.txt | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/docs/topics/testing.txt b/docs/topics/testing.txt index 8fccf32946..a1524e4f15 100644 --- a/docs/topics/testing.txt +++ b/docs/topics/testing.txt @@ -379,6 +379,15 @@ control the particular collation used by the test database. See the :doc:`settings documentation ` for details of these advanced settings. +.. admonition:: Finding data from your production database when running tests? + + If your code attempts to access the database when its modules are compiled, + this will occur *before* the test database is set up, with potentially + unexpected results. For example, if you have a database query in + module-level code and a real database exists, production data could pollute + your tests. *It is a bad idea to have such import-time database queries in + your code* anyway - rewrite your code so that it doesn't do this. + .. _topics-testing-masterslave: Testing master/slave configurations