home *** CD-ROM | disk | FTP | other *** search
/ GameStar 2006 January / Gamestar_80_2006-01_dvd.iso / Dema / Civilization4 / data1.cab / Civ4DemoComponent / Assets / Python / System / Queue.pyc (.txt) < prev    next >
Encoding:
Python Compiled Bytecode  |  2005-11-09  |  5.7 KB  |  187 lines
  1. # Source Generated with Decompyle++
  2. # File: in.pyc (Python 2.4)
  3.  
  4. '''A multi-producer, multi-consumer queue.'''
  5. from time import time as _time
  6. from collections import deque
  7. __all__ = [
  8.     'Empty',
  9.     'Full',
  10.     'Queue']
  11.  
  12. class Empty(Exception):
  13.     '''Exception raised by Queue.get(block=0)/get_nowait().'''
  14.     pass
  15.  
  16.  
  17. class Full(Exception):
  18.     '''Exception raised by Queue.put(block=0)/put_nowait().'''
  19.     pass
  20.  
  21.  
  22. class Queue:
  23.     
  24.     def __init__(self, maxsize = 0):
  25.         '''Initialize a queue object with a given maximum size.
  26.  
  27.         If maxsize is <= 0, the queue size is infinite.
  28.         '''
  29.         
  30.         try:
  31.             import threading
  32.         except ImportError:
  33.             import dummy_threading as threading
  34.  
  35.         self._init(maxsize)
  36.         self.mutex = threading.Lock()
  37.         self.not_empty = threading.Condition(self.mutex)
  38.         self.not_full = threading.Condition(self.mutex)
  39.  
  40.     
  41.     def qsize(self):
  42.         '''Return the approximate size of the queue (not reliable!).'''
  43.         self.mutex.acquire()
  44.         n = self._qsize()
  45.         self.mutex.release()
  46.         return n
  47.  
  48.     
  49.     def empty(self):
  50.         '''Return True if the queue is empty, False otherwise (not reliable!).'''
  51.         self.mutex.acquire()
  52.         n = self._empty()
  53.         self.mutex.release()
  54.         return n
  55.  
  56.     
  57.     def full(self):
  58.         '''Return True if the queue is full, False otherwise (not reliable!).'''
  59.         self.mutex.acquire()
  60.         n = self._full()
  61.         self.mutex.release()
  62.         return n
  63.  
  64.     
  65.     def put(self, item, block = True, timeout = None):
  66.         """Put an item into the queue.
  67.  
  68.         If optional args 'block' is true and 'timeout' is None (the default),
  69.         block if necessary until a free slot is available. If 'timeout' is
  70.         a positive number, it blocks at most 'timeout' seconds and raises
  71.         the Full exception if no free slot was available within that time.
  72.         Otherwise ('block' is false), put an item on the queue if a free slot
  73.         is immediately available, else raise the Full exception ('timeout'
  74.         is ignored in that case).
  75.         """
  76.         self.not_full.acquire()
  77.         
  78.         try:
  79.             if not block:
  80.                 if self._full():
  81.                     raise Full
  82.                 
  83.             elif timeout is None:
  84.                 while self._full():
  85.                     self.not_full.wait()
  86.             elif timeout < 0:
  87.                 raise ValueError("'timeout' must be a positive number")
  88.             
  89.             endtime = _time() + timeout
  90.             while self._full():
  91.                 remaining = endtime - _time()
  92.                 if remaining <= 0.0:
  93.                     raise Full
  94.                 
  95.                 self.not_full.wait(remaining)
  96.             self._put(item)
  97.             self.not_empty.notify()
  98.         finally:
  99.             self.not_full.release()
  100.  
  101.  
  102.     
  103.     def put_nowait(self, item):
  104.         '''Put an item into the queue without blocking.
  105.  
  106.         Only enqueue the item if a free slot is immediately available.
  107.         Otherwise raise the Full exception.
  108.         '''
  109.         return self.put(item, False)
  110.  
  111.     
  112.     def get(self, block = True, timeout = None):
  113.         """Remove and return an item from the queue.
  114.  
  115.         If optional args 'block' is true and 'timeout' is None (the default),
  116.         block if necessary until an item is available. If 'timeout' is
  117.         a positive number, it blocks at most 'timeout' seconds and raises
  118.         the Empty exception if no item was available within that time.
  119.         Otherwise ('block' is false), return an item if one is immediately
  120.         available, else raise the Empty exception ('timeout' is ignored
  121.         in that case).
  122.         """
  123.         self.not_empty.acquire()
  124.         
  125.         try:
  126.             if not block:
  127.                 if self._empty():
  128.                     raise Empty
  129.                 
  130.             elif timeout is None:
  131.                 while self._empty():
  132.                     self.not_empty.wait()
  133.             elif timeout < 0:
  134.                 raise ValueError("'timeout' must be a positive number")
  135.             
  136.             endtime = _time() + timeout
  137.             while self._empty():
  138.                 remaining = endtime - _time()
  139.                 if remaining <= 0.0:
  140.                     raise Empty
  141.                 
  142.                 self.not_empty.wait(remaining)
  143.             item = self._get()
  144.             self.not_full.notify()
  145.             return item
  146.         finally:
  147.             self.not_empty.release()
  148.  
  149.  
  150.     
  151.     def get_nowait(self):
  152.         '''Remove and return an item from the queue without blocking.
  153.  
  154.         Only get an item if one is immediately available. Otherwise
  155.         raise the Empty exception.
  156.         '''
  157.         return self.get(False)
  158.  
  159.     
  160.     def _init(self, maxsize):
  161.         self.maxsize = maxsize
  162.         self.queue = deque()
  163.  
  164.     
  165.     def _qsize(self):
  166.         return len(self.queue)
  167.  
  168.     
  169.     def _empty(self):
  170.         return not (self.queue)
  171.  
  172.     
  173.     def _full(self):
  174.         if self.maxsize > 0:
  175.             pass
  176.         return len(self.queue) == self.maxsize
  177.  
  178.     
  179.     def _put(self, item):
  180.         self.queue.append(item)
  181.  
  182.     
  183.     def _get(self):
  184.         return self.queue.popleft()
  185.  
  186.  
  187.