
    Vh                     b    d Z ddlmZ ddlmZ  G d de      Z G d de      Z G d d	e      Zy
)z 
Interfaces related to threads.
    )Callable)	Interfacec                       e Zd ZdZy)AlreadyQuitzJ
    This worker worker is dead and cannot execute more instructions.
    N__name__
__module____qualname____doc__     J/home/dcms/DCMS/lib/python3.12/site-packages/twisted/_threads/_ithreads.pyr   r      s    r   r   c                   2    e Zd ZdZdeg df   ddfdZddZy)IWorkerzs
    A worker that can perform some work concurrently.

    All methods on this interface must be thread-safe.
    taskNreturnc                      y)a;  
        Perform the given task.

        As an interface, this method makes no specific claims about concurrent
        execution.  An L{IWorker}'s C{do} implementation may defer execution
        for later on the same thread, immediately on a different thread, or
        some combination of the two.  It is valid for a C{do} method to
        schedule C{task} in such a way that it may never be executed.

        It is important for some implementations to provide specific properties
        with respect to where C{task} is executed, of course, and client code
        may rely on a more specific implementation of C{do} than L{IWorker}.

        @param task: a task to call in a thread or other concurrent context.
        @type task: 0-argument callable

        @raise AlreadyQuit: if C{quit} has been called.
        Nr   )r   s    r   doz
IWorker.do       r   c                       y)z
        Free any resources associated with this L{IWorker} and cause it to
        reject all future work.

        @raise AlreadyQuit: if this method has already been called.
        Nr   r   r   r   quitzIWorker.quit0   r   r   )r   N)r   r	   r
   r   r   r   r   r   r   r   r   r      s(    "d(#  (r   r   c                       e Zd ZdZy)IExclusiveWorkerz
    Like L{IWorker}, but with the additional guarantee that the callables
    passed to C{do} will not be called exclusively with each other.
    Nr   r   r   r   r   r   9   s    r   r   N)	r   typingr   zope.interfacer   	Exceptionr   r   r   r   r   r   <module>r      s7   

  $) !i !Hw r   