We don't implement all of unittest, but rather inherit from the TestCase class.
Let's also fix the references to the assert* methods.
Signed-off-by: NCleber Rosa <crosa@redhat.com>

The given example was using the old test module/class. Also, for clarity
sake, let's add the "new" import style for the Avocado Test class.
Signed-off-by: NCleber Rosa <crosa@redhat.com>

Including groupping together the "human" results and then "machine"
result formats in another subsection.

Changes from v1:
 * Wording suggestion: "on how to write a plugin" instead of "on how
   to write plugin"
Signed-off-by: NCleber Rosa <crosa@redhat.com>

We don't want users to care if some core feature is implemented as
a plugin. The important piece of information here is that Avocado
allows for its result to be written in different formats.
Signed-off-by: NCleber Rosa <crosa@redhat.com>

Besides updating the command outputs to match the current code, the
text was attempted to be made simpler and easier to follow.

Also, some sections were made subsections of the "Writing a plugin"
section.

Changes from v1:
 * Fix "lien" (instead of "line") typo
Signed-off-by: NCleber Rosa <crosa@redhat.com>

The output of the plugins command has changed. It now includes plugins
that may fail to load or even have been disabled (usually by themselves).

Let's make the user aware of these new possibilities and update the UI
examples.

Changes from v1:
 * Fix wording suggestion of "cleaner" instead of "clean"
Signed-off-by: NCleber Rosa <crosa@redhat.com>

Makefile: New `link_vt` and `link_virt` targets

Add a little more granularity to our Makefile. 'make link'
still works the way one would expect it to.
Signed-off-by: NLucas Meneghel Rodrigues <lmr@redhat.com>

Signed-off-by: NLucas Meneghel Rodrigues <lmr@redhat.com>

examples.tests: Add params descriptions

Summarize the test params to help people understand and run and
adjust test variants via multiplexer easily.
Signed-off-by: NLukáš Doktor <ldoktor@redhat.com>

  avocado.core.test: Remove the obsoleted "runTest" [v4]

The recent API reorganization made a module requiring
importlib to be loaded at setup stage. Hence the backport
python-importlib, available in EPEL, has to be added to
the BuildRequires field of the spec.
Signed-off-by: NLucas Meneghel Rodrigues <lmr@redhat.com>

The gendata is a nice example of multiple-subtests test. Add
a functional test that checks gendata creates the files
correctly and that two subtests are spawned.
Signed-off-by: NLukáš Doktor <ldoktor@redhat.com>

The runTest method has been obsoleted and everyone should be using
"test*" method(s) instead. This patch removes the support and replaces
the default and example entry points to "test".
Signed-off-by: NLukáš Doktor <ldoktor@redhat.com>

core.test: Map generic exceptions to TestError [v2]

The uid is only a test name and is not unique across the execution. We
should use tagged_name which consists of the uid and the optional tag to
be consistent with avocado runner.
Signed-off-by: NLukáš Doktor <ldoktor@redhat.com>

List all supported instrumented test statuses and add note about
BASH library to run instrumented tests.
Signed-off-by: NLukáš Doktor <ldoktor@redhat.com>

On unhandeled unknown exceptions the test should finish with ERROR
rather than FAIL as the test developer didn't think it might happen.

This behavior is configurable in config when the user have a different
opinion.
Signed-off-by: NLukáš Doktor <ldoktor@redhat.com>

avocado.core.loader: Discover only per-plugin-default tests [v2]

Loader plugins can specify default set of tests, when none supplied.
Currently list of these defaults is generated and then examined by
all loader plugins. This might generate clashes and false-negative
results, for example avocado-vt defines "vt_list_all" which obviously
shouldn't be parsed by file-plugin.

This patch changes the behavior so when no urls specified each plugin
chose and processes only his own defaults. To do this it was necessary
to reorder the recognition thus now you get all successful hits of all
urls from the first plugin, then the second....

Additionally small optimization was added to skip urls which are already
successfully assigned. This doesn't affects the results as they were
only added when not already handled.

Last minor tweak avoids false-positive result when exception occurs
during the "discover" phase as mapping is assigned after successful
discovery.
Signed-off-by: NLukáš Doktor <ldoktor@redhat.com>

Avocado: Update to release 0.25.0

Signed-off-by: NLucas Meneghel Rodrigues <lmr@redhat.com>

Update the manual page regarding wrapping process, we're using
the shell-like style to select the process to wrap on scripts.

The documentation explains the previous behavior, before
the commit f6bf2c02Signed-off-by: NRudá Moura <rmoura@redhat.com>

Signed-off-by: NCleber Rosa <crosa@redhat.com>

avocado.Test cleanup: low hanging fruits

The extra line was confusing, therefore, we shall remove
it from the logs.
Signed-off-by: NLucas Meneghel Rodrigues <lmr@redhat.com>

As as way to give `avocado.Test` users (test writers) a better sense of what
is the API allowed/intended for their use.
Signed-off-by: NCleber Rosa <crosa@redhat.com>

As as way to give `avocado.Test` users (test writers) a better sense of what
is the API allowed/intended for their use.
Signed-off-by: NCleber Rosa <crosa@redhat.com>

As as way to give `avocado.Test` users (test writers) a better sense of what
is the API allowed/intended for their use.
Signed-off-by: NCleber Rosa <crosa@redhat.com>

As as way to give `avocado.Test` users (test writers) a better sense of what
is the API allowed/intended for their use.
Signed-off-by: NCleber Rosa <crosa@redhat.com>

When wrapping process, the parameter for a local wrap is defined
by using a shell-like glob interface (*make for example).

So remove the parts that mentions the old behavior (absolute
 and relative paths comparison), before the changes
introduced in commit f6bf2c02

Also, drop obvious and thus useless comment about the wrapper when
it's expressed as a relative path
Signed-off-by: NRudá Moura <rmoura@redhat.com>

Log the information about the data directories being
used by avocado for that particular job run, with the
customary notice that avocado will use defaults in case
some directory in the config files is not accessible.
Signed-off-by: NLucas Meneghel Rodrigues <lmr@redhat.com>

Log the --tree view to the job log, whenever we have
a non empty representation of that.
Signed-off-by: NLucas Meneghel Rodrigues <lmr@redhat.com>

Add a 'root' attribute that contains the TreeNode object
of the multiplexer tree inside the Mux object. This way,
we can log the multiplexer tree in the job log.
Signed-off-by: NLucas Meneghel Rodrigues <lmr@redhat.com>