diff options
author | Cleber Rosa <crosa@redhat.com> | 2021-04-12 00:46:42 -0400 |
---|---|---|
committer | John Snow <jsnow@redhat.com> | 2021-06-01 16:21:21 -0400 |
commit | 1e4e7efa01f021e7abeb0c12ff7bb3758da22134 (patch) | |
tree | c9d4d3bbdcec0fedd7975f66abdfeb552a8a8e86 /docs/devel | |
parent | a273387aec43d2f2cff19b232c8c3e569a669971 (diff) | |
download | qemu-1e4e7efa01f021e7abeb0c12ff7bb3758da22134.zip qemu-1e4e7efa01f021e7abeb0c12ff7bb3758da22134.tar.gz qemu-1e4e7efa01f021e7abeb0c12ff7bb3758da22134.tar.bz2 |
Acceptance Tests: add basic documentation on LinuxTest base class
Signed-off-by: Cleber Rosa <crosa@redhat.com>
Reviewed-by: Marc-André Lureau <marcandre.lureau@redhat.com>
Reviewed-by: Willian Rampazzo <willianr@redhat.com>
Reviewed-by: Eric Auger <eric.auger@redhat.com>
Reviewed-by: Wainer dos Santos Moschetta <wainersm@redhat.com>
Message-Id: <20210412044644.55083-10-crosa@redhat.com>
Signed-off-by: John Snow <jsnow@redhat.com>
Diffstat (limited to 'docs/devel')
-rw-r--r-- | docs/devel/testing.rst | 26 |
1 files changed, 26 insertions, 0 deletions
diff --git a/docs/devel/testing.rst b/docs/devel/testing.rst index 1da4c4e..4e42392 100644 --- a/docs/devel/testing.rst +++ b/docs/devel/testing.rst @@ -810,6 +810,32 @@ and hypothetical example follows: At test "tear down", ``avocado_qemu.Test`` handles all the QEMUMachines shutdown. +The ``avocado_qemu.LinuxTest`` base test class +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +The ``avocado_qemu.LinuxTest`` is further specialization of the +``avocado_qemu.Test`` class, so it contains all the characteristics of +the later plus some extra features. + +First of all, this base class is intended for tests that need to +interact with a fully booted and operational Linux guest. At this +time, it uses a Fedora 31 guest image. The most basic example looks +like this: + +.. code:: + + from avocado_qemu import LinuxTest + + + class SomeTest(LinuxTest): + + def test(self): + self.launch_and_wait() + self.ssh_command('some_command_to_be_run_in_the_guest') + +Please refer to tests that use ``avocado_qemu.LinuxTest`` under +``tests/acceptance`` for more examples. + QEMUMachine ~~~~~~~~~~~ |