# coding: utf-8
# AUTO-GENERATED FILE -- DO NOT EDIT

""" This module provides primitive operations to write multi-threaded programs.
The 'threading' module provides a more convenient interface. """

class LockType(object):
  """ A lock object is a synchronization primitive.  To create a lock,
  call threading.Lock().  Methods are:
  
  acquire() -- lock the lock, possibly blocking until it can be obtained
  release() -- unlock of the lock
  locked() -- test whether the lock is currently locked
  
  A lock is not owned by the thread that locked it; another thread may
  unlock it.  A thread attempting to lock a lock that it has already locked
  will block until another thread unlocks it.  Deadlocks may ensue. """

  def acquire(self, blocking=True, timeout=-1):
    """ acquire(blocking=True, timeout=-1) -> bool
    (acquire_lock() is an obsolete synonym)
    
    Lock the lock.  Without argument, this blocks if the lock is already
    locked (even by the same thread), waiting for another thread to release
    the lock, and return True once the lock is acquired.
    With an argument, this will only block if the argument is true,
    and the return value reflects whether the lock is acquired.
    The blocking operation is interruptible. """
    return None

  def acquire_lock(self, blocking=True, timeout=-1):
    """ acquire(blocking=True, timeout=-1) -> bool
    (acquire_lock() is an obsolete synonym)
    
    Lock the lock.  Without argument, this blocks if the lock is already
    locked (even by the same thread), waiting for another thread to release
    the lock, and return True once the lock is acquired.
    With an argument, this will only block if the argument is true,
    and the return value reflects whether the lock is acquired.
    The blocking operation is interruptible. """
    return None

  def locked(self):
    """ locked() -> bool
    (locked_lock() is an obsolete synonym)
    
    Return whether the lock is in the locked state. """
    return None

  def locked_lock(self):
    """ locked() -> bool
    (locked_lock() is an obsolete synonym)
    
    Return whether the lock is in the locked state. """
    return None

  def release(self):
    """ release()
    (release_lock() is an obsolete synonym)
    
    Release the lock, allowing another thread that is blocked waiting for
    the lock to acquire the lock.  The lock must be in the locked state,
    but it needn't be locked by the same thread that unlocks it. """
    pass

  def release_lock(self):
    """ release()
    (release_lock() is an obsolete synonym)
    
    Release the lock, allowing another thread that is blocked waiting for
    the lock to acquire the lock.  The lock must be in the locked state,
    but it needn't be locked by the same thread that unlocks it. """
    pass

class RLock(object):

  def _acquire_restore(self, state):
    """ _acquire_restore(state) -> None
    
    For internal use by `threading.Condition`. """
    return None

  def _is_owned(self):
    """ _is_owned() -> bool
    
    For internal use by `threading.Condition`. """
    return None

  def _release_save(self):
    """ _release_save() -> tuple
    
    For internal use by `threading.Condition`. """
    return ()

  def acquire(self, blocking=True):
    """ acquire(blocking=True) -> bool
    
    Lock the lock.  `blocking` indicates whether we should wait
    for the lock to be available or not.  If `blocking` is False
    and another thread holds the lock, the method will return False
    immediately.  If `blocking` is True and another thread holds
    the lock, the method will wait for the lock to be released,
    take it and then return True.
    (note: the blocking operation is interruptible.)
    
    In all other cases, the method will return True immediately.
    Precisely, if the current thread already holds the lock, its
    internal counter is simply incremented. If nobody holds the lock,
    the lock is taken and its internal counter initialized to 1. """
    return None

  def release(self):
    """ release()
    
    Release the lock, allowing another thread that is blocked waiting for
    the lock to acquire the lock.  The lock must be in the locked state,
    and must be locked by the same thread that unlocks it; otherwise a
    `RuntimeError` is raised.
    
    Do note that if the lock was acquire()d several times in a row by the
    current thread, release() needs to be called as many times for the lock
    to be available for other threads. """
    pass

TIMEOUT_MAX = 4294967.0
__doc__ = """This module provides primitive operations to write multi-threaded programs.
The 'threading' module provides a more convenient interface."""

class __loader__(object):
  """ Meta path import for built-in modules.
  
      All methods are either class or static methods to avoid the need to
      instantiate the class.
  
       """

  def create_module(self, spec):
    """ Create a built-in module """
    pass

  def exec_module(self, module):
    """ Exec a built-in module """
    pass

  def find_module(self, fullname, path=None):
    """ Find the built-in module.
    
            If 'path' is ever specified then the search is considered a failure.
    
            This method is deprecated.  Use find_spec() instead.
    
             """
    pass

  def find_spec(self, fullname, path=None, target=None):
    pass

  def get_code(self, fullname):
    """ Return None as built-in modules do not have code objects. """
    pass

  def get_source(self, fullname):
    """ Return None as built-in modules do not have source code. """
    pass

  def is_package(self, fullname):
    """ Return False as built-in modules are never packages. """
    pass

  def load_module(self, fullname):
    """ Load the specified module into sys.modules and return it.
    
        This method is deprecated.  Use loader.exec_module instead.
    
         """
    pass

  def module_repr(self, module):
    """ Return repr for the module.
    
            The method is deprecated.  The import machinery does the job itself.
    
             """
    pass

__name__ = '_thread'
__package__ = ''
__spec__ = None

def _count():
  """ _count() -> integer
  
  Return the number of currently running Python threads, excluding 
  the main thread. The returned number comprises all threads created
  through `start_new_thread()` as well as `threading.Thread`, and not
  yet finished.
  
  This function is meant for internal and specialized purposes only.
  In most applications `threading.enumerate()` should be used instead. """
  return 1

class _local(object):
  """ Thread-local data """

  pass

def _set_sentinel():
  """ _set_sentinel() -> lock
  
  Set a sentinel lock that will be released when the current thread
  state is finalized (after it is untied from the interpreter).
  
  This is a private API for the threading module. """
  return None

def allocate():
  """ allocate_lock() -> lock object
  (allocate() is an obsolete synonym)
  
  Create a new lock object. See help(type(threading.Lock())) for
  information about locks. """
  return None

def allocate_lock():
  """ allocate_lock() -> lock object
  (allocate() is an obsolete synonym)
  
  Create a new lock object. See help(type(threading.Lock())) for
  information about locks. """
  return None

class error(Exception):
  """ Unspecified run-time error. """

  def __init__(self, *args, **kwargs):
    pass

def exit():
  """ exit()
  (exit_thread() is an obsolete synonym)
  
  This is synonymous to ``raise SystemExit''.  It will cause the current
  thread to exit silently unless the exception is caught. """
  pass

def exit_thread():
  """ exit()
  (exit_thread() is an obsolete synonym)
  
  This is synonymous to ``raise SystemExit''.  It will cause the current
  thread to exit silently unless the exception is caught. """
  pass

def get_ident():
  """ get_ident() -> integer
  
  Return a non-zero integer that uniquely identifies the current thread
  amongst other threads that exist simultaneously.
  This may be used to identify per-thread resources.
  Even though on some platforms threads identities may appear to be
  allocated consecutive numbers starting at 1, this behavior should not
  be relied upon, and the number should be seen purely as a magic cookie.
  A thread's identity may be reused for another thread after it exits. """
  return 1

def interrupt_main():
  """ interrupt_main()
  
  Raise a KeyboardInterrupt in the main thread.
  A subthread can use this function to interrupt the main thread. """
  pass

def stack_size(size=None):
  """ stack_size([size]) -> size
  
  Return the thread stack size used when creating new threads.  The
  optional size argument specifies the stack size (in bytes) to be used
  for subsequently created threads, and must be 0 (use platform or
  configured default) or a positive integer value of at least 32,768 (32k).
  If changing the thread stack size is unsupported, a ThreadError
  exception is raised.  If the specified size is invalid, a ValueError
  exception is raised, and the stack size is unmodified.  32k bytes
   currently the minimum supported stack size value to guarantee
  sufficient stack space for the interpreter itself.
  
  Note that some platforms may have particular restrictions on values for
  the stack size, such as requiring a minimum stack size larger than 32 KiB or
  requiring allocation in multiples of the system memory page size
  - platform documentation should be referred to for more information
  (4 KiB pages are common; using multiples of 4096 for the stack size is
  the suggested approach in the absence of more specific information). """
  return None

def start_new(function, args, kwargs=None):
  """ start_new_thread(function, args[, kwargs])
  (start_new() is an obsolete synonym)
  
  Start a new thread and return its identifier.  The thread will call the
  function with positional arguments from the tuple args and keyword arguments
  taken from the optional dictionary kwargs.  The thread exits when the
  function returns; the return value is ignored.  The thread will also exit
  when the function raises an unhandled exception; a stack trace will be
  printed unless the exception is SystemExit.
   """
  pass

def start_new_thread(function, args, kwargs=None):
  """ start_new_thread(function, args[, kwargs])
  (start_new() is an obsolete synonym)
  
  Start a new thread and return its identifier.  The thread will call the
  function with positional arguments from the tuple args and keyword arguments
  taken from the optional dictionary kwargs.  The thread exits when the
  function returns; the return value is ignored.  The thread will also exit
  when the function raises an unhandled exception; a stack trace will be
  printed unless the exception is SystemExit.
   """
  pass