==================== 91.0 Thelma & Louise ==================== The Avocado team is proud to present another release: Avocado 91.0, AKA "Thelma & Louise", is now available! Release documentation: `Avocado 91.0 `_ Important Announcement ====================== Avocado has switched the default runner, from the implementation most people currently use (internally simply called ``runner``), to the newer architecture and implementation called ``nrunner``. **Users installing and relying on the latest Avocado release will be impacted by this change and should act accordingly.** To keep using the current (soon to be legacy) runner, you **must** set the ``--test-runner=runner`` command line option (or the equivalent ``test_runner`` configuration option, under section ``[run]``). Known issues are being tracked on our GitHub project page, with the ``nrunner`` tag, and new issue reports are appreciated. Users/Test Writers ================== * As per the previous section, the ``nrunner`` test runner implementation is now the default on every ``avocado run`` command (or equivalent Job API scripts). Since the previous release, ``nrunner`` supports: 1. the "fail fast" (``run --failfast``) feature. 2. :ref:`the varianter ` feature. 3. UNIX domain sockets as the communication channel with runners (the new default). 4. a ``sysinfo`` runner, which will allow for sysinfo collection on any supported spawner. 5. early notification of missing runners for tasks in the requested suite. * The assets plugin fetch command (``avocado assets fetch``) now supports: 1. fetching assets defined in a Python list in ``INSTRUMENTED`` tests. 2. setting a timeout for the download of assets. * Improved checks when users attempt to use the varianter and simple parameters (``-p``) at the same time. * The Podman spawner (``--nrunner-spawner=podman``) will now attempt to use a Container image (``--spawner-podman-image=``) that matches the host Linux distribution. If it's not possible to detect the host distribution, the latest Fedora image will be used. Bug Fixes ========= * The extraction of DEB packages by means of :func:`avocado.utils.software_manager.SoftwareManager.extract_from_package` was fixed and does not depend on ``ar`` utility anymore (as it now uses the :mod:`avocado.utils.ar` module). * The ``--store-logging-stream`` parameter value was being incorrectly parsed as a list of characters. If a ``bar`` value is given, it would generate the ``b.INFO``, ``a.INFO``, and ``r.INFO`` file. The fix parses the command line arguments by treating the value as a comma separated list (that becomes a set). * ``nrunner`` will now properly translate reference names with absolute paths into Python unittest "dotted names". * The ``TAP`` parser (:mod:`avocado.core.tapparser`) will not choke on unexpected content, ignoring it according to the standard. * :class:`avocado.core.nrunner.Runnables` created by suites will now contain the full suite configuration. * If a job contains multiple test suites with the same name, and tests within those suites also have the same name, test results would be overwritten. Now job name uniqueness is enforced and no test results from a suite should be able to overwrite other's. * Some occurrences of the incorrect ``AVOCADO_TEST_OUTPUT_DIR`` environment variable name were renamed to the proper name (``AVOCADO_TEST_OUTPUTDIR``). Utility APIs ============ * :class:`avocado.utils.network.interfaces.NetworkInterface` can now access and present information on interfaces that do not have an IP address assigned to them. * :mod:`avocado.utils.distro` can now detect the distribution on remote machines. * A new :mod:`avocado.utils.ar` module was introduced that allows extraction of UNIX ``ar`` archive contents. * A new :mod:`avocado.utils.sysinfo` module that powers the ``sysinfo`` feature, but is now also accessible to job/test writers. * Times related to the duration of tasks are now limited to nanosecond precision to improve readability. * The :mod:`avocado.utils.distro` will now correctly return a :data:`avocado.utils.distro.UNKNOWN_DISTRO` on non UNIX systems, instead of crashing. * The :mod:`avocado.utils.network.hosts` won't consider anymore ``bonding_masters``, a file that may exist at ``/sys/class/net``, as the name of an interface. Misc Changes ============ * Many documentation improvements. * The ``setup.py`` script received many improvements, including: 1. A new ``test`` command implementation. 2. A new ``plugin`` command. * Various logging related improvements, especially regarding the elimination of Python's root logger usage. Internal Changes ================ * Major improvements to the CI, including: 1. additional tests for ``setup.py`` 2. most of the "pre-release" test plan was migrated to a CI job * The :func:`avocado.Test.workdir` is now initialized lazily, which prevents never used work directories from being created and kept in the test results' directory. * A circular import condition was fixed related to the Settings plugins initialized during avocado early initialization. * A rename of the ``requirements-selftests.txt`` file to ``requirements-dev.txt`` to better capture the fact that the selftests requirements are a subset of the requirements needed for development. * ``selftests/safeloader.sh`` now supports checking a single file. * Debugging aids were added to the Task/StateMachine/Repo systems of the ``nrunner``. These can be seen by default at the ``avocado.core.DEBUG`` file in the job's result directory. * An ``nrunner`` based job its tasks are now better bound by the job ID, with messages being logged in case the status server receives messages destined for another job. * The very long and detailed temporary directory prefix used on ``TestCaseTmpDir`` was shortened so that limitations on paths such as socket names are not easily hit. * Clean up of duplicate methods in the :class:`avocado.core.loader.FileLoader` class. --- For more information, please check out the complete `Avocado changelog `_.