step.wait_for_seconds_dsl
=========================

.. py:module:: step.wait_for_seconds_dsl

.. autoapi-nested-parse::

   Auto-generated step builders and DSL functions — DO NOT EDIT.

   Source: wait_for_seconds.py



Classes
-------

.. autoapisummary::

   step.wait_for_seconds_dsl.WaitForSecondsBuilder


Functions
---------

.. autoapisummary::

   step.wait_for_seconds_dsl.wait_for_seconds


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

.. py:class:: WaitForSecondsBuilder

   Bases: :py:obj:`raccoon.step.step_builder.StepBuilder`


   Builder for WaitForSeconds. Auto-generated — do not edit.


   .. py:method:: seconds(value: Union[float, int])


.. py:function:: wait_for_seconds(seconds: Union[float, int] = _UNSET)

   Pause execution for a fixed number of seconds.

   Suspends the current step sequence for the specified duration using
   an async sleep. No hardware commands are issued during the wait, and
   other concurrent tasks (e.g. odometry updates) continue running
   normally. The wait duration is deterministic and is reflected
   accurately in simulation estimates.

   :param seconds: Duration to pause in seconds. Must be non-negative. Passing 0 yields control to the event loop for one tick without any meaningful delay.

   :returns: A WaitForSecondsBuilder (chainable via ``.seconds()``, ``.on_anomaly()``, ``.skip_timing()``).

   Example::

       from raccoon.step import wait

       # Pause between two motor commands
       sequence(
           motor_power(robot.motor(0), 100),
           wait(2.5),
           motor_brake(robot.motor(0)),
       )

       # Brief yield to let sensors settle
       wait(0.1)