Test-time and local configuration for tests.
A Context object contains all of the information a test needs to
execute, beyond what is stored as part of the test specification
itself. Information in the context can include,
Local (per-user, etc.) configuration, such as where to find the
tested program.
Environmental information, such as which machine the test is
running on.
One-time configuration, including test arguments specified on
the command line.
A Context object is effectively a mapping object whose keys must
be labels and values must be strings.
|
Methods
|
|
|
|
|
|
GetAddedProperties
|
GetAddedProperties ( self )
Return the properties added to this context by resources.
- returns
- A map from strings to values indicating properties
that were added to this context by resources.
|
|
|
GetBoolean
|
GetBoolean (
self,
key,
default=None,
)
Return the boolean value associated with key.
-
key
- A string.
-
default
- A default boolean value.
- returns
- The value associated with
key in the context,
interpreted as a boolean.
If there is no value associated with key and default is not
None, then the boolean value associated with default is
used. If there is no value associated with key and default
is None, an exception is raised.
The value associated with key must be a string. If not, an
exception is raised. If the value is a string, but does not
correspond to a boolean value, an exception is raised.
|
Exceptions
|
|
ContextException( key )
ContextException( key, "invalid boolean context var" )
|
|
|
|
GetTemporaryDirectory
|
GetTemporaryDirectory ( self )
Return the path to the a temporary directory.
- returns
- The path to the a temporary directory. The
Runnable object may make free use of this temporary
directory; no other 'Runnable's will use the same directory at
the same time.
|
|
|
Read
|
Read ( self, file_name )
Read the context file file_name.
-
file_name
- The name of the context file.
Reads the context file and adds the context properties in the
file to self.
|
Exceptions
|
|
qm.cmdline.CommandError, msg
qm.cmdline.CommandError, qm.error( "could not read file", path = file_name )
|
|
|
|
__contains__
|
__contains__ ( self, key )
|
|
|
__getitem__
|
__getitem__ ( self, key )
|
|
|
__init__
|
__init__ ( self, context=None )
Construct a new context.
-
context
- If not
None, the existing Context being
wrapped by this new context.
|
|
|
get
|
get (
self,
key,
default=None,
)
|
|
|
has_key
|
has_key ( self, key )
|
|
|
items
|
items ( self )
|
|