tests.utils.session_utils
=========================

.. py:module:: tests.utils.session_utils


Attributes
----------

.. autoapisummary::

   tests.utils.session_utils.logger


Functions
---------

.. autoapisummary::

   tests.utils.session_utils.expect_pattern_live
   tests.utils.session_utils.fvp_power_cycle_and_reconnect
   tests.utils.session_utils.login_and_wait_for_shell


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

.. py:data:: logger

.. py:function:: expect_pattern_live(session, pattern, timeout, msg, level = 'info')

   Wait for a specific pattern to appear in a live pexpect session.

   :param session: Active pexpect session instance.
   :param pattern: Pattern to wait for in the session output.
   :param timeout: Maximum time (in seconds) to wait.
   :param msg: Log message to emit if a timeout occurs.
   :param level: Logging level to use.
   :returns: True if the pattern is matched within the timeout


.. py:function:: fvp_power_cycle_and_reconnect(platform_base_obj, platform_bundle, boot_wait_seconds = 0)

   Power cycle the FVP instance and restore console connectivity.

   :param platform_base_obj: Initialized :class:`AutoTestPlatformBase`.
   :param platform_bundle: Initialized driver bundle.
   :param boot_wait_seconds: Optional delay in seconds
   :returns: None


.. py:function:: login_and_wait_for_shell(session, login_prompt, shell_prompt)

   Complete login sequence and wait for root shell prompt.

   :param login_prompt: login prompt pattern
   :param shell_prompt: shell prompt pattern
   :returns: None