=====================
Long Running Commands
=====================

.. note:: 
   The LRC :ref:`deprecated-client-api` has been moved to its own page, as it will be updated in a future release to be compatible with any SKA Tango command - fast or long running.

.. automodule:: ska_tango_base.long_running_commands.mixin
   :members:
   :exclude-members: LRCMixin, AbstractLRCMixin
   :no-index:

.. autoclass:: ska_tango_base.long_running_commands.mixin.LRCMixin
   :members:
   :show-inheritance:
   :no-index:

   .. py:attribute:: lrcQueue
      :type: list[str]
      :no-index:

      Tango attribute returning a table describing queued long running commands.

      Each element of the list is a JSON object with the following keys:

         - ``"uid"`` - Unique identifier for the command (``str``)
         - ``"name"`` - Name of the command (``str``)
         - ``"submitted_time"`` - Timestamp when the command was submitted (``str``)

   .. py:attribute:: lrcExecuting
      :type: list[str]
      :no-index:

      Tango attribute returning a table describing currently executing long running commands.

      Each element of the list is a JSON object with the following keys:

         - ``"uid"`` - Unique identifier for the command (``str``)
         - ``"name"`` - Name of the command (``str``)
         - ``"submitted_time"`` - Timestamp when the command was submitted (``str``)
         - ``"started_time"`` - Timestamp when the command was started (``str``)
         - ``"progress"`` - Percentage completion (optional, ``int``)

   .. py:attribute:: lrcFinished
      :type: list[str]
      :no-index:

      Tango attribute returning a table describing finished long running commands.

      Each element of the list is a JSON object with the following keys:

         - ``"uid"`` - Unique identifier for the command (``str``)
         - ``"name"`` - Name of the command (``str``)
         - ``"submitted_time"`` - Timestamp when the command was submitted (``str``)
         - ``"started_time"`` - Timestamp when the command was started (``str``)
         - ``"finished_time"`` - Timestamp when the command finished (``str``)
         - ``"result"`` - JSON encoded result of command (``str``)
         - ``"status"`` - TaskStatus the command finished with (``str``)
         - ``"progress"`` - Percentage completion (optional, ``int``)

.. autoclass:: ska_tango_base.long_running_commands.mixin.AbstractLRCMixin
   :show-inheritance:
   :members:
   :no-index:

.. automodule:: ska_tango_base.long_running_commands.decorators
   :members:
   :no-index: