step.wait_for_button
====================

.. py:module:: step.wait_for_button


Classes
-------

.. autoapisummary::

   step.wait_for_button.WaitForButton


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

.. py:class:: WaitForButton(message: str = 'Waiting for button press...')

   Bases: :py:obj:`raccoon.ui.UIStep`


   Wait for the operator to press the hardware button before continuing.

   Blocks the step sequence until the physical button on the robot
   controller is pressed. A message is displayed on the UI while
   waiting. This is useful for pausing between autonomous phases,
   confirming the robot is correctly positioned before starting, or
   gating destructive actions behind human approval.

   :param message: Text displayed on screen while waiting for the button
                   press. Defaults to ``"Waiting for button press..."``.

   Example::

       from raccoon.step import wait_for_button

       # Wait for the operator to confirm placement before starting
       sequence(
           wait_for_button("Place robot at starting position"),
           motor_power(robot.motor(0), 100),
           wait(3.0),
           motor_brake(robot.motor(0)),
       )