avocado.core.remote package

Submodules

avocado.core.remote.result module

Remote test results.

class avocado.core.remote.result.RemoteResult(job)

Bases: avocado.core.result.HumanResult

Remote Machine Test Result class.

Creates an instance of RemoteResult.

Parameters:job – an instance of avocado.core.job.Job.
tear_down()

Cleanup after test execution

class avocado.core.remote.result.VMResult(job)

Bases: avocado.core.remote.result.RemoteResult

Virtual Machine Test Result class.

avocado.core.remote.runner module

Remote test runner.

class avocado.core.remote.runner.RemoteTestRunner(job, test_result)

Bases: avocado.core.runner.TestRunner

Tooled TestRunner to run on remote machine using ssh

check_remote_avocado()

Checks if the remote system appears to have avocado installed

The “appears to have” description is justified by the fact that the check is rather simplistic, it attempts to run an avocado -v command and checks if the output looks like what avocado would print out.

Return type:tuple with (bool, tuple)
Returns:(True, (x, y, z)) if avocado appears to be installed and (False, None) otherwise.
remote = None

remoter connection to the remote machine

remote_test_dir = '~/avocado/tests'
remote_version_re = <_sre.SRE_Pattern object>
run_suite(test_suite, mux, timeout=0, replay_map=None, test_result_total=0)

Run one or more tests and report with test result.

Parameters:
  • params_list – a list of param dicts.
  • mux – A multiplex iterator (unused here)
Returns:

a set with types of test failures.

run_test(urls, timeout)

Run tests.

Parameters:urls – a string with test URLs.
Returns:a dictionary with test results.
setup()

Setup remote environment and copy test directories

tear_down()

This method is only called when run_suite gets to the point of to be executing setup method and is called at the end of the execution.

Warning:It might be called on setup exceptions, so things initialized during setup might not yet be initialized.
class avocado.core.remote.runner.VMTestRunner(job, test_result)

Bases: avocado.core.remote.runner.RemoteTestRunner

Test runner to run tests using libvirt domain

setup()

Initialize VM and establish connection

tear_down()

Stop VM and restore snapshot (if asked for it)

vm = None

VM used during testing

avocado.core.remote.test module

Remote test class.

class avocado.core.remote.test.RemoteTest(name, status, time, start, end, fail_reason, logdir, logfile)

Bases: object

Mimics avocado.core.test.Test for remote tests.

get_state()

Serialize selected attributes representing the test state

Returns:a dictionary containing relevant test state data
Return type:dict

Module contents

class avocado.core.remote.RemoteResult(job)

Bases: avocado.core.result.HumanResult

Remote Machine Test Result class.

Creates an instance of RemoteResult.

Parameters:job – an instance of avocado.core.job.Job.
tear_down()

Cleanup after test execution

class avocado.core.remote.VMResult(job)

Bases: avocado.core.remote.result.RemoteResult

Virtual Machine Test Result class.

class avocado.core.remote.RemoteTestRunner(job, test_result)

Bases: avocado.core.runner.TestRunner

Tooled TestRunner to run on remote machine using ssh

check_remote_avocado()

Checks if the remote system appears to have avocado installed

The “appears to have” description is justified by the fact that the check is rather simplistic, it attempts to run an avocado -v command and checks if the output looks like what avocado would print out.

Return type:tuple with (bool, tuple)
Returns:(True, (x, y, z)) if avocado appears to be installed and (False, None) otherwise.
remote_test_dir = '~/avocado/tests'
remote_version_re = <_sre.SRE_Pattern object>
run_suite(test_suite, mux, timeout=0, replay_map=None, test_result_total=0)

Run one or more tests and report with test result.

Parameters:
  • params_list – a list of param dicts.
  • mux – A multiplex iterator (unused here)
Returns:

a set with types of test failures.

run_test(urls, timeout)

Run tests.

Parameters:urls – a string with test URLs.
Returns:a dictionary with test results.
setup()

Setup remote environment and copy test directories

tear_down()

This method is only called when run_suite gets to the point of to be executing setup method and is called at the end of the execution.

Warning:It might be called on setup exceptions, so things initialized during setup might not yet be initialized.
class avocado.core.remote.VMTestRunner(job, test_result)

Bases: avocado.core.remote.runner.RemoteTestRunner

Test runner to run tests using libvirt domain

setup()

Initialize VM and establish connection

tear_down()

Stop VM and restore snapshot (if asked for it)

class avocado.core.remote.RemoteTest(name, status, time, start, end, fail_reason, logdir, logfile)

Bases: object

Mimics avocado.core.test.Test for remote tests.

get_state()

Serialize selected attributes representing the test state

Returns:a dictionary containing relevant test state data
Return type:dict