The information in this topic may be out of date. The current SDK reference guide has moved here.
open method
Call this method to start a test, before calling any of the check methods.
Syntax
outdriver = eyes.open(app_name, test_name, dimension)
outdriver = eyes.open(app_name, test_name)
Parameters
- app_name
- Type:Text
- The application name. This may be any string. You can set the application name for all tests using the Configuration.set_app_name method. If you do so, then set this parameter to a value of None to indicate that the configuration default should be used.
- test_name
- Type:Text
- The name of the test. This name must be unique within the scope of the application name. It may be any string.
- dimension
- Type:ViewPort [Optional : default = None ]
- If this parameter is not provided, and the viewport was not set using the undefined,
then the viewport size is taken from the dimensions of the image of the first checkpoint.
For the image SDK this is used to identify the baseline and does not affect the way
the checkpoint image is processed in any other way.
Type definitions
- ViewPort
- The type ViewPort is defined as: Union[Dict[Text,int],RectangleSize]
Return value
- Type: None
Remarks
After making a call to this method, you must eventually terminate the test by calling
Eyes.close
(in case of a normal completion) or
Eyes.abort
(in case of an aborted test).
If you want to run another test, then it is recomended to do this with a newly
created Eyes instance to avoid side effects. However, in principle, it is legal to call
Eyes.open again to start a new test
on the same Eyes instance.