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>

Due to this new feature, remove the previous 'show
plugins that had problems to load' feature', given
the overlap between the two.
Signed-off-by: NLucas Meneghel Rodrigues <lmr@redhat.com>

Dump all the configuration values being
used at the moment by avocado.
Signed-off-by: NLucas Meneghel Rodrigues <lmr@redhat.com>

Add the avocado version number to the job debug info,
and if we can identify this directory as the avocado
source directory, also print avocado git repo info.
Signed-off-by: NLucas Meneghel Rodrigues <lmr@redhat.com>

So that people can easily read, copy and paste the command
lines into their terminals.
Signed-off-by: NLucas Meneghel Rodrigues <lmr@redhat.com>

Let's move the job debug information logging to private
methods, in order to organize the code better.
Signed-off-by: NLucas Meneghel Rodrigues <lmr@redhat.com>

With the new information that is going to be added to
the job log, keeping up with the number of lines of that
log is a fool's errand at this point. Let's drop the checks.
Signed-off-by: NLucas Meneghel Rodrigues <lmr@redhat.com>

We recently updated that representation.
Signed-off-by: NLucas Meneghel Rodrigues <lmr@redhat.com>