class documentation

Undocumented

Method set_as_test_mirror Set this database up to be used in testing as a mirror of a primary database whose settings are given.
Method test_db_signature Return a tuple with elements of self.connection.settings_dict (a DATABASES setting value) that uniquely identify a database accordingly to the RDBMS particularities.
Method _create_test_db Internal implementation - create the test db tables.
Method _create_test_user Undocumented
Method _destroy_test_db Destroy a test database, prompting the user for confirmation if the database already exists. Return the name of the test database created.
Method _destroy_test_user Undocumented
Method _execute_allow_fail_statements Execute statements which are allowed to fail silently if the Oracle error code given by `acceptable_ora_err` is raised. Return True if the statements execute without an exception, or False otherwise.
Method _execute_statements Undocumented
Method _execute_test_db_creation Undocumented
Method _execute_test_db_destruction Undocumented
Method _get_test_db_name Return the 'production' DB name to get the test DB creation machinery to work. This isn't a great deal in this case because DB names as handled by Django don't have real counterparts in Oracle.
Method _get_test_db_params Undocumented
Method _handle_objects_preventing_db_destruction Undocumented
Method _switch_to_test_user Switch to the user that's used for creating the test database.
Method _test_database_create Undocumented
Method _test_database_name Undocumented
Method _test_database_oracle_managed_files Undocumented
Method _test_database_passwd Undocumented
Method _test_database_tblspace Undocumented
Method _test_database_tblspace_datafile Undocumented
Method _test_database_tblspace_extsize Undocumented
Method _test_database_tblspace_maxsize Undocumented
Method _test_database_tblspace_size Undocumented
Method _test_database_tblspace_tmp Undocumented
Method _test_database_tblspace_tmp_datafile Undocumented
Method _test_database_tblspace_tmp_extsize Undocumented
Method _test_database_tblspace_tmp_maxsize Undocumented
Method _test_database_tblspace_tmp_size Undocumented
Method _test_database_user Undocumented
Method _test_settings_get Return a value from the test settings dict, or a given default, or a prefixed entry from the main settings dict.
Method _test_user_create Undocumented
Property _maindb_connection This is analogous to other backends' `_nodb_connection` property, which allows access to an "administrative" connection which can be used to manage the test databases. For Oracle, the only connection that can be used for that purpose is the main (non-test) connection.

Inherited from BaseDatabaseCreation:

Method __init__ Undocumented
Method clone_test_db Clone a test database.
Method create_test_db Create a test database, prompting the user for confirmation if the database already exists. Return the name of the test database created.
Method deserialize_db_from_string Reload the database with data from a string generated by the serialize_db_to_string() method.
Method destroy_test_db Destroy a test database, prompting the user for confirmation if the database already exists.
Method get_test_db_clone_settings Return a modified connection settings dict for the n-th clone of a DB.
Method log Undocumented
Method mark_expected_failures_and_skips Mark tests in Django's test suite which are expected failures on this database and test which should be skipped on this database.
Method serialize_db_to_string Serialize all data in the database into a JSON string. Designed only for test runner usage; will not handle large amounts of data.
Method setup_worker_connection Undocumented
Method sql_table_creation_suffix SQL to append to the end of the test table creation statements.
Instance Variable connection Undocumented
Method _clone_test_db Internal implementation - duplicate the test db tables.
Method _execute_create_test_db Undocumented
Method _get_database_display_str Return display string for a database for use in various actions.
Method _nodb_cursor Undocumented
def set_as_test_mirror(self, primary_settings_dict): (source)

Set this database up to be used in testing as a mirror of a primary database whose settings are given.

def test_db_signature(self): (source)

Return a tuple with elements of self.connection.settings_dict (a DATABASES setting value) that uniquely identify a database accordingly to the RDBMS particularities.

def _create_test_db(self, verbosity=1, autoclobber=False, keepdb=False): (source)

Internal implementation - create the test db tables.

def _create_test_user(self, cursor, parameters, verbosity, keepdb=False): (source)

Undocumented

def _destroy_test_db(self, test_database_name, verbosity=1): (source)

Destroy a test database, prompting the user for confirmation if the database already exists. Return the name of the test database created.

def _destroy_test_user(self, cursor, parameters, verbosity): (source)

Undocumented

def _execute_allow_fail_statements(self, cursor, statements, parameters, verbosity, acceptable_ora_err): (source)

Execute statements which are allowed to fail silently if the Oracle error code given by `acceptable_ora_err` is raised. Return True if the statements execute without an exception, or False otherwise.

def _execute_statements(self, cursor, statements, parameters, verbosity, allow_quiet_fail=False): (source)

Undocumented

def _execute_test_db_creation(self, cursor, parameters, verbosity, keepdb=False): (source)

Undocumented

def _execute_test_db_destruction(self, cursor, parameters, verbosity): (source)

Undocumented

def _get_test_db_name(self): (source)

Return the 'production' DB name to get the test DB creation machinery to work. This isn't a great deal in this case because DB names as handled by Django don't have real counterparts in Oracle.

def _get_test_db_params(self): (source)

Undocumented

def _handle_objects_preventing_db_destruction(self, cursor, parameters, verbosity, autoclobber): (source)

Undocumented

def _switch_to_test_user(self, parameters): (source)

Switch to the user that's used for creating the test database. Oracle doesn't have the concept of separate databases under the same user, so a separate user is used; see _create_test_db(). The main user is also needed for cleanup when testing is completed, so save its credentials in the SAVED_USER/SAVED_PASSWORD key in the settings dict.

def _test_database_create(self): (source)

Undocumented

def _test_database_name(self): (source)

Undocumented

def _test_database_oracle_managed_files(self): (source)

Undocumented

def _test_database_passwd(self): (source)

Undocumented

def _test_database_tblspace(self): (source)

Undocumented

def _test_database_tblspace_datafile(self): (source)

Undocumented

def _test_database_tblspace_extsize(self): (source)

Undocumented

def _test_database_tblspace_maxsize(self): (source)

Undocumented

def _test_database_tblspace_size(self): (source)

Undocumented

def _test_database_tblspace_tmp(self): (source)

Undocumented

def _test_database_tblspace_tmp_datafile(self): (source)

Undocumented

def _test_database_tblspace_tmp_extsize(self): (source)

Undocumented

def _test_database_tblspace_tmp_maxsize(self): (source)

Undocumented

def _test_database_tblspace_tmp_size(self): (source)

Undocumented

def _test_database_user(self): (source)

Undocumented

def _test_settings_get(self, key, default=None, prefixed=None): (source)

Return a value from the test settings dict, or a given default, or a prefixed entry from the main settings dict.

def _test_user_create(self): (source)

Undocumented

@cached_property
_maindb_connection = (source)

This is analogous to other backends' `_nodb_connection` property, which allows access to an "administrative" connection which can be used to manage the test databases. For Oracle, the only connection that can be used for that purpose is the main (non-test) connection.