# mini_buildd.threads module

class mini_buildd.threads.NoLock

  Bases: `object`

  Debug/temporary only: Experienced dead locks – not reliably reproducible for now

  May-be-related to our locking here. Use this to exclude our locking once we can reproduce the lockdown.

  acquire()
  release()

class mini_buildd.threads.Thread(subthreads=None, **kwargs)

  Bases: `Thread`

  abstractmethod shutdown()
  start()

    Start the thread’s activity.

    It must be called at most once per thread object. It arranges for the object’s run() method to be invoked in a separate thread of control.

    This method will raise a RuntimeError if called more than once on the same thread object.

  join(timeout=None)

    Wait until the thread terminates.

    This blocks the calling thread until the thread whose join() method is called terminates – either normally or through an unhandled exception or until the optional timeout occurs.

    When the timeout argument is present and not None, it should be a floating-point number specifying a timeout for the operation in seconds (or fractions thereof). As join() always returns None, you must call is_alive() after join() to decide whether a timeout happened – if the thread is still alive, the join() call timed out.

    When the timeout argument is not present or None, the operation will block until the thread terminates.

    A thread can be join()ed many times.

    join() raises a RuntimeError if an attempt is made to join the current thread as that would cause a deadlock. It is also an error to join() a thread before it has been started and attempts to do so raises the same exception.

  abstractmethod mbd_run()
  run()

    Method representing the thread’s activity.

    You may override this method in a subclass. The standard run() method invokes the callable object passed to the object’s constructor as the target argument, if any, with sequential and keyword arguments taken from the args and kwargs arguments, respectively.

class mini_buildd.threads.DeferredThread(limiter, **kwargs)

  Bases: `Thread`

  abstractmethod run_deferred()
  shutdown()
  mbd_run()

class mini_buildd.threads.EventThread(**kwargs)

  Bases: `Thread`

  abstractmethod run_event(event)
  shutdown()
  mbd_run()

class mini_buildd.threads.PollerThread(sleep=60, **kwargs)

  Bases: `Thread`

  abstractmethod run_poller()
  shutdown()
  mbd_run()