This syncs the manpage with the latest changes of command line options
and plugins (for example, the new multiplex).
Signed-off-by: NCleber Rosa <crosa@redhat.com>

Move options to test runner,  plugins has priority and app parser has the test runner parser

Fix functional tests regarding the changes that moves
options from the main application to the test runner (avocado run).
Signed-off-by: NRuda Moura <rmoura@redhat.com>

Move plugins journal, json, xunit and vm inside the test runner
subcommand, now the command line options belongs to the runner,
instead of the main application.
Signed-off-by: NRuda Moura <rmoura@redhat.com>

Export the test runner parser back to the main parser,
so you can use `parser.runner` to extend it.
Signed-off-by: NRuda Moura <rmoura@redhat.com>

Add priority when loading plugins (both built-in or external).
The lowest the priority (0 by default) then earliest the plugin will
be loaded.

In the current implementation, only the runner plugin has
priority 0 and the other plug-ins are all defined as priority 3.
Signed-off-by: NRuda Moura <rmoura@redhat.com>

test progress API: removed simplistic check_progress() idea

The check_progress() idea is too simplistic for what we aim for,
so let's remove it to prevent test writers from depending on it.

Also, rename communicate_state() to report_state().
Signed-off-by: NCleber Rosa <crosa@redhat.com>

Trivial fixes sprint12

In avocado, we use 'less' for a paginator. When one presses
'q' in the paginator, an IOError is raised (the subprocess
opened with os.popen has just quit), so let's introduce a
Paginator class, that can handle cleanly 'q' without asking
API users to handle the exception themselves.
Signed-off-by: NLucas Meneghel Rodrigues <lmr@redhat.com>

Make it have the same meaning as with the previous
multiplex system (9 variants, loop and sync parameters
with short, medium and long variants).
Signed-off-by: NLucas Meneghel Rodrigues <lmr@redhat.com>

Make the multiplexer plugin to properly produce the
environment relative to each variant. Before, we
had an exception when calling option -c.
Signed-off-by: NLucas Meneghel Rodrigues <lmr@redhat.com>

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

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

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

avocado.docs: Update documentation regarding argument parsing.

Update documentation regarding the last update on argument parsing.
Like option --silent goes to run subcommand and there's no
need to quote for multiples test names.
Signed-off-by: NRuda Moura <rmoura@redhat.com>

avocado.test: Use job.unique_id to build temporary path.

if job.unique_id is available in test, use this information
to build the temporary path used in attribute workdir.

The template format is $TMP/job-<unique_id>-<random>/.
Signed-off-by: NRuda Moura <rmoura@redhat.com>

avocado.cli.parser: New way to parsing arguments.

The parser for the subcommand run now accepts one or more
tests ids (paths / aliases) and there isn't a need to quote the list
as a string.

Example:

* Before: avocado 'sleeptest failtest /usr/bin/true'
* Now: avocado sleeptest failtest /usr/bin/true

So it's now possible to run avocado like `avocado run *.py`.
Signed-off-by: NRuda Moura <rmoura@redhat.com>

Remove generic option --silent and turn it to subcommand run.
Signed-off-by: NRuda Moura <rmoura@redhat.com>

On Plugin.configure(), remove app_parser and cmd_parser arguments
and now use parse, an instance of avocado.cli.parser.Parser().
The application (old app_parser) is available with parser.application.
The subcommands (old cmd_parser) is available with parser.subcommands.

Now the runner plugins (like sysinfo, datadir, run, etc.)
make use of the standard method run() to execute the logic.
Signed-off-by: NRuda Moura <rmoura@redhat.com>

Modify how we parse command line arguments,
by removing the logic that was inside avocado.cli.app into
this new module.
Signed-off-by: NRuda Moura <rmoura@redhat.com>

Debian updates

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

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

avocado.core.tree: Add copyright note

Attributing copyright to Jaime Huerta-Cepas <jhcepas@gmail.com>,
author of the original tree node structure, that we drew inspiration
from and used part of the code (tree drawing).

CC: Jaime Huerta-Cepas <jhcepas@gmail.com>
Signed-off-by: NLucas Meneghel Rodrigues <lmr@redhat.com>

Refactory plugins

Build devhelp files for Avocado

Rename `arc` to `avocado`.
Plus:  change instructions for devhelp.
Signed-off-by: NRuda Moura <rmoura@redhat.com>

Use `Avocado` to project name.
Signed-off-by: NRuda Moura <rmoura@redhat.com>

Bump to the latest version, released after sprint 11.
Signed-off-by: NLucas Meneghel Rodrigues <lmr@redhat.com>

avocado.process: Make processes to fail when interrupted by user

So that the avocado command does produce its
intended output. Fixes a small bug introduced with
the simplification of the json and xunit plugins.
Signed-off-by: NLucas Meneghel Rodrigues <lmr@redhat.com>

Some tests, such as the trinity test, may pass even
when interrupted (Ctrl+C), and that is counter intuitive
with the expected semantic of Ctrl+C. So, even if a command
passed, let's raise a CmdError exception if interrupted.
Signed-off-by: NLucas Meneghel Rodrigues <lmr@redhat.com>

Signed-off-by: NRuda Moura <rmoura@redhat.com>

Add new "hello world!" plugin, to perform functional tests
on external plugins.

Created class ExternalPluginsTest() to move all
functional tests regarding external plugins there.
Signed-off-by: NRuda Moura <rmoura@redhat.com>