id	summary	reporter	owner	description	type	status	component	version	severity	resolution	keywords	cc	stage	has_patch	needs_docs	needs_tests	needs_better_patch	easy	ui_ux
5430	incomplete docs for running Django's own unit tests	Antti Kaihola	Antti Kaihola	"At http://www.djangoproject.com/documentation/contributing/#unit-tests under the title ""Running the unit tests"", the documentation states:

{{{
Yes, the unit tests need a settings module,
but only for database connection info,
with the DATABASE_ENGINE setting.
You will also need a ROOT_URLCONF setting
(its value is ignored; it just needs to be present)
and a SITE_ID setting (any non-zero integer value
will do) in order for all the tests to pass.

The unit tests will not touch your existing databases;
they create a new database, called django_test_db,
which is deleted when the tests are finished.
This means your user account needs permission
to execute CREATE DATABASE.
}}}

For SQLite the above is true, but for at least PostgreSQL also {{{DATABASE_NAME}}} and {{{DATABASE_USER}}} need to be specified, and {{{DATABASE_NAME}}} must be the name of an existing database to which the user has access, but it *must not* be {{{django_test_db}}}."		closed	Documentation	dev		fixed			Accepted	0	0	0	0	0	0