Merge pull request #1 from lmr/docs

avocado-virt: Add docs directory
avocado.virt: Add defaults module

The defaults module will be used to store commonly
used default values in virt testing, such as:

* QEMU default paths
* Guest default paths

Signed-off-by: Lucas Meneghel Rodrigues <lmr@redhat.com>
avocado.virt: Figure out guest image path if none provided

It is a common use case that people just want to use a particular
guest image file on a test. That can be done using the newly
introduced test runner option --guest-image-path. This value
is going to be passed to the test, and in case none is provided,
use what the virt.defaults module tells we should use.

With this we get extra flexibility and convenience running our
tests.

Signed-off-by: Lucas Meneghel Rodrigues <lmr@redhat.com>
avocado.virt: Add option --disable-restore-image-test

By default, restore image files if possible. As some
people might want to save time, give them that option
through command line flag --disable-restore-image-test.

Signed-off-by: Lucas Meneghel Rodrigues <lmr@redhat.com>
avocado.virt: Add option --disable-restore-image-job

Allow people to skip all uncompress guest image stages
if both --disable-restore-image-test and the new option,
--disable-restore-image-job are provided. If only the
former is provided, do the setup at plugin activation
stage. Print a 'Please wait...' message only if the
alternative output plugins (xunit and json) are not
claiming the application stdout.

Signed-off-by: Lucas Meneghel Rodrigues <lmr@redhat.com>
avocado.plugins.virt: Add virt related parser group

This will organize the virt options better, helping
the logical display of command line arguments.

Signed-off-by: Lucas Meneghel Rodrigues <lmr@redhat.com>
avocado.virt.qemu.devices: Simplify image path resolution code

Somehow, embarassingly I've missed this equivalent, much
more elegant construction. Thanks to Ruda and Cleber for
letting me realize my mistake.

Signed-off-by: Lucas Meneghel Rodrigues <lmr@redhat.com>
avocado.plugins.virt: Remove redundant 'dest' declarations

Argparse already creates those exact same destination
variables by default, rendering the explicit declarations
unnecessary.

Signed-off-by: Lucas Meneghel Rodrigues <lmr@redhat.com>
Merge pull request #2 from lmr/sprint-13

Sprint 13
avocado.virt.test: Assemble a basic VM command line at setup

Instead of letting the test writer to mess around with creating
a basic QEMU command line, create a basic VM command line, and
let the users with the task of starting it up/shutting it down.

The resulting object can be accessed using self.vm.

Signed-off-by: Lucas Meneghel Rodrigues <lmr@redhat.com>
avocado.virt.qemu.machine: VM method name changes

The summary of the changes:

* launch() becomes power_on()
* shutdown() becomes power_off()
* setup_remote_login() becomes login_remote()

The name changes were discussed upon Sprint 13 review,
it basically boils down to more elusive, familiar names.

Signed-off-by: Lucas Meneghel Rodrigues <lmr@redhat.com>
avocado-virt: Bumping release to 0.1.3

Signed-off-by: Lucas Meneghel Rodrigues <lmr@redhat.com>
Merge pull request #3 from lmr/api_simplify_sprint13

API Simplify Sprint 14
avocado.virt.defaults: Add guest_user and guest_password

As this will be a user configurable option.

Signed-off-by: Lucas Meneghel Rodrigues <lmr@redhat.com>
avocado: Add --guest-user and --guest-password options

Users may want to use different images, with different
setups. Allow them to override the remote login defaults
that the virt plugin assumes.

Signed-off-by: Lucas Meneghel Rodrigues <lmr@redhat.com>
avocado.virt.qemu.machine: .login_remote() method update

Make it honor arguments passed in the test runner command
line.

Signed-off-by: Lucas Meneghel Rodrigues <lmr@redhat.com>
docs: API updates and new GuestConfiguration session

Update to the latest API state and cover how to set
up custom linux guest images.

Signed-off-by: Lucas Meneghel Rodrigues <lmr@redhat.com>
Merge pull request #4 from lmr/add-options-sprint14

Add options Sprint 14