tests.utils.fwu_utils
=====================

.. py:module:: tests.utils.fwu_utils


Attributes
----------

.. autoapisummary::

   tests.utils.fwu_utils.logger


Functions
---------

.. autoapisummary::

   tests.utils.fwu_utils.check_block_device
   tests.utils.fwu_utils.check_mount
   tests.utils.fwu_utils.check_file
   tests.utils.fwu_utils.prepare_capsule_environment
   tests.utils.fwu_utils.check_system_status


Module Contents
---------------

.. py:data:: logger

.. py:function:: check_block_device(platform_base_obj, dev)

   Verify that a block device exists on target.

   :param platform_base_obj: Platform fixture containing manager
   :param dev: Device path
   :returns: None


.. py:function:: check_mount(platform_base_obj, target, source, error_msg)

   Verify that a mount exists using findmnt linux command

   :param platform_base_obj: Platform fixture containing manager
   :param target: target to mount the device
   :param source: Expected device
   :param error_msg: Msg in case of failure
   :returns: None


.. py:function:: check_file(platform_base_obj, path, error_msg)

   Verify that a file exists on target.

   :param platform_base_obj: Platform fixture containing manager
   :param path: File path
   :param error_msg: Msg in case of failure
   :returns: None


.. py:function:: prepare_capsule_environment(platform_base_obj)

   Mount boot, verify devices, check capsule, and copy file


.. py:function:: check_system_status(platform_base_obj, timeout = 200)

   Verify that systemd reaches ``running`` state after FWU flow.

   If running state is not reached, this helper drains pending console output,
   collects failed systemd units, and fails the test with diagnostics.

   :param platform_base_obj: Platform fixture containing manager
   :param timeout: Reserved timeout argument
   :returns: None