mirror of
				https://github.com/django/django.git
				synced 2025-11-03 21:25:09 +00:00 
			
		
		
		
	Updated references to the TEST_* database settings.
They were removed in Django 1.9. I could leave the reference to TEST_DEPENDENCIES in the 1.2.4 release notes because the link points to the right location and the name was accurate at the time.
This commit is contained in:
		
							parent
							
								
									d06014db53
								
							
						
					
					
						commit
						6d1110f2f0
					
				
					 3 changed files with 33 additions and 21 deletions
				
			
		| 
						 | 
					@ -137,7 +137,7 @@ class BaseDatabaseCreation(object):
 | 
				
			||||||
        Internal implementation - returns the name of the test DB that will be
 | 
					        Internal implementation - returns the name of the test DB that will be
 | 
				
			||||||
        created. Only useful when called from create_test_db() and
 | 
					        created. Only useful when called from create_test_db() and
 | 
				
			||||||
        _create_test_db() and when no external munging is done with the 'NAME'
 | 
					        _create_test_db() and when no external munging is done with the 'NAME'
 | 
				
			||||||
        or 'TEST_NAME' settings.
 | 
					        settings.
 | 
				
			||||||
        """
 | 
					        """
 | 
				
			||||||
        if self.connection.settings_dict['TEST']['NAME']:
 | 
					        if self.connection.settings_dict['TEST']['NAME']:
 | 
				
			||||||
            return self.connection.settings_dict['TEST']['NAME']
 | 
					            return self.connection.settings_dict['TEST']['NAME']
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
| 
						 | 
					@ -62,7 +62,7 @@ The :setting:`DATABASES` setting in any test settings module needs to define
 | 
				
			||||||
two databases:
 | 
					two databases:
 | 
				
			||||||
 | 
					
 | 
				
			||||||
* A ``default`` database. This database should use the backend that
 | 
					* A ``default`` database. This database should use the backend that
 | 
				
			||||||
  you want to use for primary testing
 | 
					  you want to use for primary testing.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
* A database with the alias ``other``. The ``other`` database is used to
 | 
					* A database with the alias ``other``. The ``other`` database is used to
 | 
				
			||||||
  establish that queries can be directed to different databases. As a result,
 | 
					  establish that queries can be directed to different databases. As a result,
 | 
				
			||||||
| 
						 | 
					@ -86,8 +86,8 @@ These test databases are deleted when the tests are finished.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
You will also need to ensure that your database uses UTF-8 as the default
 | 
					You will also need to ensure that your database uses UTF-8 as the default
 | 
				
			||||||
character set. If your database server doesn't use UTF-8 as a default charset,
 | 
					character set. If your database server doesn't use UTF-8 as a default charset,
 | 
				
			||||||
you will need to include a value for :setting:`TEST_CHARSET` in the settings
 | 
					you will need to include a value for :setting:`CHARSET <TEST_CHARSET>` in the
 | 
				
			||||||
dictionary for the applicable database.
 | 
					test settings dictionary for the applicable database.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
.. _runtests-specifying-labels:
 | 
					.. _runtests-specifying-labels:
 | 
				
			||||||
 | 
					
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
| 
						 | 
					@ -97,7 +97,9 @@ configuration::
 | 
				
			||||||
            'ENGINE': 'django.db.backends.mysql',
 | 
					            'ENGINE': 'django.db.backends.mysql',
 | 
				
			||||||
            'NAME': 'myproject',
 | 
					            'NAME': 'myproject',
 | 
				
			||||||
            'HOST': 'dbreplica',
 | 
					            'HOST': 'dbreplica',
 | 
				
			||||||
            'TEST_MIRROR': 'default'
 | 
					            'TEST': {
 | 
				
			||||||
 | 
					                'MIRROR': 'default',
 | 
				
			||||||
 | 
					            },
 | 
				
			||||||
            # ... plus some other settings
 | 
					            # ... plus some other settings
 | 
				
			||||||
        }
 | 
					        }
 | 
				
			||||||
    }
 | 
					    }
 | 
				
			||||||
| 
						 | 
					@ -111,8 +113,8 @@ normal activity, any write to ``default`` will appear on ``replica``.
 | 
				
			||||||
If Django created two independent test databases, this would break any
 | 
					If Django created two independent test databases, this would break any
 | 
				
			||||||
tests that expected replication to occur. However, the ``replica``
 | 
					tests that expected replication to occur. However, the ``replica``
 | 
				
			||||||
database has been configured as a test mirror (using the
 | 
					database has been configured as a test mirror (using the
 | 
				
			||||||
:setting:`TEST_MIRROR` setting), indicating that under testing,
 | 
					:setting:`MIRROR <TEST_MIRROR>` test setting), indicating that under
 | 
				
			||||||
``replica`` should be treated as a mirror of ``default``.
 | 
					testing, ``replica`` should be treated as a mirror of ``default``.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
When the test environment is configured, a test version of ``replica``
 | 
					When the test environment is configured, a test version of ``replica``
 | 
				
			||||||
will *not* be created. Instead the connection to ``replica``
 | 
					will *not* be created. Instead the connection to ``replica``
 | 
				
			||||||
| 
						 | 
					@ -132,41 +134,51 @@ However, no guarantees are made on the creation order of any other
 | 
				
			||||||
databases in your test setup.
 | 
					databases in your test setup.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
If your database configuration requires a specific creation order, you
 | 
					If your database configuration requires a specific creation order, you
 | 
				
			||||||
can specify the dependencies that exist using the
 | 
					can specify the dependencies that exist using the :setting:`DEPENDENCIES
 | 
				
			||||||
:setting:`TEST_DEPENDENCIES` setting. Consider the following
 | 
					<TEST_DEPENDENCIES>` test setting. Consider the following (simplified)
 | 
				
			||||||
(simplified) example database configuration::
 | 
					example database configuration::
 | 
				
			||||||
 | 
					
 | 
				
			||||||
    DATABASES = {
 | 
					    DATABASES = {
 | 
				
			||||||
        'default': {
 | 
					        'default': {
 | 
				
			||||||
             # ... db settings
 | 
					            # ... db settings
 | 
				
			||||||
             'TEST_DEPENDENCIES': ['diamonds']
 | 
					            'TEST': {
 | 
				
			||||||
 | 
					                'DEPENDENCIES': ['diamonds'],
 | 
				
			||||||
 | 
					            },
 | 
				
			||||||
        },
 | 
					        },
 | 
				
			||||||
        'diamonds': {
 | 
					        'diamonds': {
 | 
				
			||||||
            # ... db settings
 | 
					             ... db settings
 | 
				
			||||||
             'TEST_DEPENDENCIES': []
 | 
					            'TEST': {
 | 
				
			||||||
 | 
					                'DEPENDENCIES': [],
 | 
				
			||||||
 | 
					            },
 | 
				
			||||||
        },
 | 
					        },
 | 
				
			||||||
        'clubs': {
 | 
					        'clubs': {
 | 
				
			||||||
            # ... db settings
 | 
					            # ... db settings
 | 
				
			||||||
            'TEST_DEPENDENCIES': ['diamonds']
 | 
					            'TEST': {
 | 
				
			||||||
 | 
					                'DEPENDENCIES': ['diamonds'],
 | 
				
			||||||
 | 
					            },
 | 
				
			||||||
        },
 | 
					        },
 | 
				
			||||||
        'spades': {
 | 
					        'spades': {
 | 
				
			||||||
            # ... db settings
 | 
					            # ... db settings
 | 
				
			||||||
            'TEST_DEPENDENCIES': ['diamonds','hearts']
 | 
					            'TEST': {
 | 
				
			||||||
 | 
					                'DEPENDENCIES': ['diamonds', 'hearts'],
 | 
				
			||||||
 | 
					            },
 | 
				
			||||||
        },
 | 
					        },
 | 
				
			||||||
        'hearts': {
 | 
					        'hearts': {
 | 
				
			||||||
            # ... db settings
 | 
					            # ... db settings
 | 
				
			||||||
            'TEST_DEPENDENCIES': ['diamonds','clubs']
 | 
					            'TEST': {
 | 
				
			||||||
 | 
					                'DEPENDENCIES': ['diamonds', 'clubs'],
 | 
				
			||||||
 | 
					            },
 | 
				
			||||||
        }
 | 
					        }
 | 
				
			||||||
    }
 | 
					    }
 | 
				
			||||||
 | 
					
 | 
				
			||||||
Under this configuration, the ``diamonds`` database will be created first,
 | 
					Under this configuration, the ``diamonds`` database will be created first,
 | 
				
			||||||
as it is the only database alias without dependencies. The ``default`` and
 | 
					as it is the only database alias without dependencies. The ``default`` and
 | 
				
			||||||
``clubs`` alias will be created next (although the order of creation of this
 | 
					``clubs`` alias will be created next (although the order of creation of this
 | 
				
			||||||
pair is not guaranteed); then ``hearts``; and finally ``spades``.
 | 
					pair is not guaranteed), then ``hearts``, and finally ``spades``.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
If there are any circular dependencies in the
 | 
					If there are any circular dependencies in the :setting:`DEPENDENCIES
 | 
				
			||||||
:setting:`TEST_DEPENDENCIES` definition, an ``ImproperlyConfigured``
 | 
					<TEST_DEPENDENCIES>` definition, an
 | 
				
			||||||
exception will be raised.
 | 
					:exc:`~django.core.exceptions.ImproperlyConfigured` exception will be raised.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
Advanced features of ``TransactionTestCase``
 | 
					Advanced features of ``TransactionTestCase``
 | 
				
			||||||
============================================
 | 
					============================================
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
		Loading…
	
	Add table
		Add a link
		
	
		Reference in a new issue