Python 2.6 / EL6 fixes [v2]

The sleeptenmin example test contains `self.report_state` which should
not be called directly and it defines variable which is not used.
Signed-off-by: NLukáš Doktor <ldoktor@redhat.com>

We have been running the selftests during the build of the Fedora
packages, but have skipped that on EL6 (and EL7).  The reason is that
there were a few packages missing from EPEL.

They're now present on the EPEL 6 repos so let's enable checks while
building EL6 packages.

Some functional tests are failing on EL7, and fixing those and
enabling checks for EL7 packages will be the scope of further work.
Signed-off-by: NCleber Rosa <crosa@redhat.com>

When no C compiler is available, these tests will produce errors.
Let's skip them when the requirements cannot be met.
Signed-off-by: NCleber Rosa <crosa@redhat.com>

Older python-sphinx cannot handle newer inventory files (objects.inv).
While this is not fail proof, as there can be newer python-sphinx on
older Python, but it seems to be good enough as it works on all system
setups I tested.
Signed-off-by: NCleber Rosa <crosa@redhat.com>

Some older versions of sphinx do not ship with `sphinx-apidoc`.
Instead of breaking the document generation and selftests, let's just
skip the generation of API docs.
Signed-off-by: NCleber Rosa <crosa@redhat.com>

And not based on Python version.  It was observed that platforms based
on Python 2.6, such as EL6, do ship with setuptools that has support
for `--user`.  This eases considerably the development environment
on these platforms.
Signed-off-by: NCleber Rosa <crosa@redhat.com>

This will change the behavior one gets with `make develop` so that
optional (but in-tree) plugins will be enabled by default.  For now,
this means enabling the HTML result plugin.

This also means that `make check` will also test those by default,
as it's already been done on Travis CI.
Signed-off-by: NCleber Rosa <crosa@redhat.com>

avocado.core.test: Always use "test" as methodName in dry-run

selftests: Use LC_ALL=C in tests which parse output

docs: Add note about args vs. positional args [v2]

Add link to the Avocado tests for Scylla Clusters

* https://github.com/avocado-framework/avocado:
  avocado/core/job.py: remove unused method _filter_test_suite

The filtering of test methods is now implemented at the loader module.
This is an unused leftover from older versions, so let's remove it.
Signed-off-by: NCleber Rosa <crosa@redhat.com>

* https://github.com/avocado-framework/avocado:
  Added version file and updated the respective files

Added version file and updated the respective files

Currently one of the test_output tests depends on a correct English
message, but the test runs under the system locales. Let's force the
LC_ALL for that execution.
Signed-off-by: NLukáš Doktor <ldoktor@redhat.com>

The --dry-run replaces the test class with a special one instead. When
the original class used a different but "test" methodName this fails
during __init__ as unittest requires the methodName attribute to exists.
This patch always changes the methodName to "test", which is defined in
the fake dry-run class.
Signed-off-by: NLukáš Doktor <ldoktor@redhat.com>

The python's argparse is quite clever and usually evaluates the
positionals and arguments correctly. But with subparsers or weird test
names it might falsely evaluate test name as argument, for example:

    avocado run --my_test
    avocado run passtest.py --show-job-log failtest.py

those will fail as --my_test looks like an invalid option and
--show-job-log is subparser's option not known to the main parser but as
the main parser already filled positionals it evaluates the
`failtest.py` as extra argument.

The most appropriate way to distinguish between args and positional args
is the `--` separator:

    avocado run -- --my_test
    avocado run --show-job-log -- passtest.py failtest.py
Signed-off-by: NLukáš Doktor <ldoktor@redhat.com>

* https://github.com/avocado-framework/avocado:
  selftests/checkall: skip `.git` directory on inspekt based checks

`.git` may hold content that ends up being checked by inspektor, such
as the `git-rerere` cache.  This may cause false positives, so let's
skip `.git` completetly from those checks.
Signed-off-by: NCleber Rosa <crosa@redhat.com>

The avocado package was renamed in 760d82c9 to `avocado-framework`,
but the cleanup was left unchanged. This commit fixes it.
Signed-off-by: NLukáš Doktor <ldoktor@redhat.com>

avocado: Few little improvements to listing local vars

Improve virt module exceptions/messages when it is not able to connect
to libvirt and when the domain is not available.

Reference: https://trello.com/c/Ni1LvaMQSigned-off-by: NAmador Pahim <apahim@redhat.com>

The use of stacktrace.log_message is not really necessary as the test
already has `self.log` which is the actual log we want to write to.
Signed-off-by: NLukáš Doktor <ldoktor@redhat.com>

It could be useful to see not only key/value pairs, but also their
types. As the value could be pretty long this patch logs the type just
after the key.
Signed-off-by: NLukáš Doktor <ldoktor@redhat.com>

docs: add section on Avocado installation using pip

This patch enables all the optional plugins in travis to increate the
test coverage.

Reference: https://trello.com/c/UHdVHzOZSigned-off-by: NAmador Pahim <apahim@redhat.com>

We have introduced updated packages (41.0) to PyPI, which now support
a much improved installation experience using pip. Let's add a section
on that.

While on that, let's restructure the sub sections levels.  The proposal
here for the sub sections on the "Installing Avocado" section is:

   1) Installing from Packages
   1.1) Fedora
   1.2) Enterprise Linux
   2) Generic installation from a GIT repository
   3) Installing from standard Python tools
Signed-off-by: NCleber Rosa <crosa@redhat.com>

When the test fails, it is useful to expose the local variables of the
test function.
Signed-off-by: NAmador Pahim <apahim@redhat.com>

* https://github.com/avocado-framework/avocado:
  rename make to run_make which using process.run
  fix style compatible to pep8 standard

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

* spell:
  spell.ignore: add exceptions for this release

Adding exception to the spell.ignore.
Signed-off-by: NAmador Pahim <apahim@redhat.com>