Package qm :: Package test :: Package classes :: Module sql_result_stream :: Class SQLResultStream

Class SQLResultStream

            object --+        
                     |        
   extension.Extension --+    
                         |    
result_stream.ResultStream --+
                             |
            object --+       |
                     |       |
   extension.Extension --+   |
                         |   |
             _SQLConnected --+
                             |
                            SQLResultStream

A 'SQLResultStream' writes results out to an SQL database.

This class currently supports PostgreSQL only.

Nested Classes

[hide private]

Inherited from extension.Extension: Type, __metaclass__

Instance Methods

[hide private]

__init__(self, arguments=None, **args)
Construct a new 'Extension'.

source code

WriteAnnotation(self, key, value)
Output an annotation for this run.

source code

WriteResult(self, result)
Output a test result.

source code

Summarize(self)
Output summary information about the results.

source code

Inherited from result_stream.ResultStream: WriteAllAnnotations

Inherited from result_stream.ResultStream (private): _GetExpectedOutcome

Inherited from extension.Extension: GetClassName, GetExplicitArguments, MakeDomDocument, MakeDomElement, Write, __getattr__

Inherited from object: __delattr__, __format__, __getattribute__, __hash__, __new__, __reduce__, __reduce_ex__, __repr__, __setattr__, __sizeof__, __str__, __subclasshook__

Class Variables

[hide private]

_argument_dictionary = {'connection': <<class 'qm.fields.Pytho...
A map from argument names to 'Field' instances.

_argument_list = [<<class 'qm.fields.TextField'> db_module>, <...
A list of all the 'Field's in this class.

Inherited from result_stream.ResultStream: expected_outcomes, kind

Inherited from _SQLConnected: arguments, connection, db_module, db_name

Inherited from extension.Extension (private): _allow_arg_names_matching_class_vars

Properties

[hide private]

Inherited from object: __class__

Method Details

[hide private]

init(self, arguments=None, **args)
(Constructor)

source code

Construct a new 'Extension'.

'args': Keyword arguments providing values for Extension parameters. The values should be appropriate for the corresponding fields. Derived classes must pass along any unrecognized keyword arguments to this method so that additional arguments can be added in the future without necessitating changes to derived classes.

This method will place all of the arguments into this objects instance dictionary.

Derived classes may override this method, but should call this method during their processing.

Overrides: object.__init__: (inherited documentation)

WriteAnnotation(self, key, value)

source code

Output an annotation for this run.

Subclasses should override this if they want to store/display annotations; the default implementation simply discards them.

'key' -- the key value as a string.

'value' -- the value of this annotation as a string.

Overrides: result_stream.ResultStream.WriteAnnotation: (inherited documentation)

WriteResult(self, result)

source code

Output a test result.

Subclasses must override this method; the default implementation raises a 'NotImplementedError'.

'result' -- A 'Result'.

Overrides: result_stream.ResultStream.WriteResult: (inherited documentation)

Summarize(self)

source code

Output summary information about the results.

When this method is called, the test run is complete. Summary information should be displayed for the user, if appropriate. Any finalization, such as the closing of open files, should also be performed at this point.

Derived class methods may override this method. They should, however, invoke this version before returning.

Overrides: result_stream.ResultStream.Summarize: (inherited documentation)

Class Variable Details

[hide private]

_argument_dictionary

A map from argument names to 'Field' instances.

A map from the names of arguments for this class to the corresponding 'Field'.

Value:

{'connection': <<class 'qm.fields.PythonField'> connection>,
 'db_module': <<class 'qm.fields.TextField'> db_module>,
 'db_name': <<class 'qm.fields.TextField'> db_name>,
 'expected_outcomes': <<class 'qm.fields.PythonField'> expected_outcom
es>}

_argument_list

A list of all the 'Field's in this class.

This list combines the complete list of 'arguments'. 'Field's appear in the order reached by a pre-order breadth-first traversal of the hierarchy, starting from the most derived class.

Value:

[<<class 'qm.fields.TextField'> db_module>,
 <<class 'qm.fields.PythonField'> expected_outcomes>,
 <<class 'qm.fields.PythonField'> connection>,
 <<class 'qm.fields.TextField'> db_name>]

Class SQLResultStream

__init__(self, arguments=None, **args) (Constructor)

WriteAnnotation(self, key, value)

WriteResult(self, result)

Summarize(self)

_argument_dictionary

_argument_list

init(self, arguments=None, **args)
(Constructor)