bundle.core.process
===================

.. py:module:: bundle.core.process


Attributes
----------

.. autoapisummary::

   bundle.core.process.log


Exceptions
----------

.. autoapisummary::

   bundle.core.process.ProcessError


Classes
-------

.. autoapisummary::

   bundle.core.process.ProcessResult
   bundle.core.process.Process
   bundle.core.process.ProcessStream


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

.. py:data:: log

.. py:class:: ProcessResult(/, **data: Any)

   Bases: :py:obj:`bundle.core.data.Data`


   Data class to store the result of a process execution.


   .. py:attribute:: command
      :type:  str


   .. py:attribute:: returncode
      :type:  int


   .. py:attribute:: stdout
      :type:  str


   .. py:attribute:: stderr
      :type:  str


.. py:exception:: ProcessError(process: Process | ProcessStream, result: ProcessResult)

   Bases: :py:obj:`Exception`


   Custom exception for process execution errors.


   .. py:attribute:: result


.. py:class:: Process(/, **data: Any)

   Bases: :py:obj:`bundle.core.entity.Entity`


   Asynchronously executes shell commands and captures their output.


.. py:class:: ProcessStream(/, **data: Any)

   Bases: :py:obj:`Process`


   Executes a command asynchronously and streams output line by line.


   .. py:method:: callback_stdout(line: str)
      :async:


      Default stdout handler: writes directly to sys.stdout.



   .. py:method:: callback_stderr(line: str)
      :async:


      Default stderr handler: writes directly to sys.stderr.