U
     T‚g  ã                   @   sP   d Z ddlmZ ddlmZ G dd„ deƒZG dd„ deƒZG dd	„ d	eƒZd
S )z 
Interfaces related to threads.
é    )ÚCallable)Ú	Interfacec                   @   s   e Zd ZdZdS )ÚAlreadyQuitzJ
    This worker worker is dead and cannot execute more instructions.
    N©Ú__name__Ú
__module__Ú__qualname__Ú__doc__© r
   r
   ú>/tmp/pip-unpacked-wheel-1_7di8ic/twisted/_threads/_ithreads.pyr      s   r   c                   @   s6   e Zd ZdZeg df ddœdd„Zddœdd„ZdS )	ÚIWorkerzs
    A worker that can perform some work concurrently.

    All methods on this interface must be thread-safe.
    N)ÚtaskÚreturnc                 C   s   dS )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   r
   r
   r   Údo   s    z
IWorker.do)r   c                   C   s   dS )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
   r   Úquit0   s    zIWorker.quit)r   r   r   r	   r   r   r   r
   r
   r
   r   r      s   r   c                   @   s   e Zd ZdZdS )Ú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   N)	r	   Útypingr   Zzope.interfacer   Ú	Exceptionr   r   r   r
   r
   r
   r   Ú<module>   s
   $