libstp.timing.synchronizer
==========================

.. py:module:: libstp.timing.synchronizer


Classes
-------

.. autoapisummary::

   libstp.timing.synchronizer.Synchronizer


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

.. py:class:: Synchronizer

   Mission-relative clock used by checkpoint-aware timing steps.


   .. py:attribute:: start_time
      :value: None



   .. py:method:: start_recording()

      Capture the current event-loop time as checkpoint zero.



   .. py:method:: get_time()

      Return seconds elapsed since ``start_recording()`` was called.



   .. py:method:: wait_until_checkpoint(checkpoint_seconds)
      :async:


      Sleep until the mission-relative checkpoint or log that it was missed.



   .. py:method:: do_until_checkpoint(checkpoint_seconds, func, *args, **kwargs)
      :async:


      Execute a function until the specified checkpoint is reached.

      :param checkpoint_seconds: The time in seconds to wait until the checkpoint.
      :param func: The function to execute.
      :param \*args: Positional arguments for the function.
      :param \*\*kwargs: Keyword arguments for the function.