[svn r37264] create the new development trunk

--HG--
branch : trunk
This commit is contained in:
hpk
2007-01-24 15:24:01 +01:00
commit 5992a8ef21
435 changed files with 58640 additions and 0 deletions

1
py/thread/__init__.py Normal file
View File

@@ -0,0 +1 @@
#

81
py/thread/io.py Normal file
View File

@@ -0,0 +1,81 @@
import thread
class ThreadOut(object):
""" A file like object that diverts writing operations
to per-thread writefuncs.
This is a py lib internal class and not meant for outer use
or modification.
"""
def __new__(cls, obj, attrname):
""" Divert file output to per-thread writefuncs.
the given obj and attrname describe the destination
of the file.
"""
current = getattr(obj, attrname)
if isinstance(current, cls):
current._used += 1
return current
self = object.__new__(cls)
self._tid2out = {}
self._used = 1
self._oldout = getattr(obj, attrname)
self._defaultwriter = self._oldout.write
self._address = (obj, attrname)
setattr(obj, attrname, self)
return self
def isatty(self):
# XXX
return False
def setdefaultwriter(self, writefunc):
self._defaultwriter = writefunc
def resetdefault(self):
self._defaultwriter = self._oldout.write
def softspace():
def fget(self):
return self._get()[0]
def fset(self, value):
self._get()[0] = value
return property(fget, fset, None, "software attribute")
softspace = softspace()
def deinstall(self):
self._used -= 1
x = self._used
if x <= 0:
obj, attrname = self._address
setattr(obj, attrname, self._oldout)
def setwritefunc(self, writefunc, tid=None):
assert callable(writefunc)
if tid is None:
tid = thread.get_ident()
self._tid2out[tid] = [0, writefunc]
def delwritefunc(self, tid=None, ignoremissing=True):
if tid is None:
tid = thread.get_ident()
try:
del self._tid2out[tid]
except KeyError:
if not ignoremissing:
raise
def _get(self):
tid = thread.get_ident()
try:
return self._tid2out[tid]
except KeyError:
return getattr(self._defaultwriter, 'softspace', 0), self._defaultwriter
def write(self, data):
softspace, out = self._get()
out(data)
def flush(self):
pass

206
py/thread/pool.py Normal file
View File

@@ -0,0 +1,206 @@
import Queue
import threading
import time
import sys
ERRORMARKER = object()
class Reply(object):
""" reply instances provide access to the result
of a function execution that got dispatched
through WorkerPool.dispatch()
"""
_excinfo = None
def __init__(self, task):
self.task = task
self._queue = Queue.Queue()
def _set(self, result):
self._queue.put(result)
def _setexcinfo(self, excinfo):
self._excinfo = excinfo
self._queue.put(ERRORMARKER)
def _get_with_timeout(self, timeout):
# taken from python2.3's Queue.get()
# we want to run on python2.2 here
delay = 0.0005 # 500 us -> initial delay of 1 ms
endtime = time.time() + timeout
while 1:
try:
return self._queue.get_nowait()
except Queue.Empty:
remaining = endtime - time.time()
if remaining <= 0: #time is over and no element arrived
raise IOError("timeout waiting for task %r" %(self.task,))
delay = min(delay * 2, remaining, .05)
time.sleep(delay) #reduce CPU usage by using a sleep
def get(self, timeout=None):
""" get the result object from an asynchronous function execution.
if the function execution raised an exception,
then calling get() will reraise that exception
including its traceback.
"""
if self._queue is None:
raise EOFError("reply has already been delivered")
if timeout is not None:
result = self._get_with_timeout(timeout)
else:
result = self._queue.get()
if result is ERRORMARKER:
self._queue = None
excinfo = self._excinfo
raise excinfo[0], excinfo[1], excinfo[2]
return result
class WorkerThread(threading.Thread):
def __init__(self, pool):
threading.Thread.__init__(self)
self._queue = Queue.Queue()
self._pool = pool
self.setDaemon(1)
def _run_once(self):
reply = self._queue.get()
if reply is SystemExit:
return False
assert self not in self._pool._ready
task = reply.task
try:
func, args, kwargs = task
result = func(*args, **kwargs)
except (SystemExit, KeyboardInterrupt):
return False
except:
reply._setexcinfo(sys.exc_info())
else:
reply._set(result)
# at this point, reply, task and all other local variables go away
return True
def run(self):
try:
while self._run_once():
self._pool._ready[self] = True
finally:
del self._pool._alive[self]
try:
del self._pool._ready[self]
except KeyError:
pass
def send(self, task):
reply = Reply(task)
self._queue.put(reply)
return reply
def stop(self):
self._queue.put(SystemExit)
class WorkerPool(object):
""" A WorkerPool allows to dispatch function executions
to threads. Each Worker Thread is reused for multiple
function executions. The dispatching operation
takes care to create and dispatch to existing
threads.
You need to call shutdown() to signal
the WorkerThreads to terminate and join()
in order to wait until all worker threads
have terminated.
"""
_shuttingdown = False
def __init__(self, maxthreads=None):
""" init WorkerPool instance which may
create up to `maxthreads` worker threads.
"""
self.maxthreads = maxthreads
self._ready = {}
self._alive = {}
def dispatch(self, func, *args, **kwargs):
""" return Reply object for the asynchronous dispatch
of the given func(*args, **kwargs) in a
separate worker thread.
"""
if self._shuttingdown:
raise IOError("WorkerPool is already shutting down")
try:
thread, _ = self._ready.popitem()
except KeyError: # pop from empty list
if self.maxthreads and len(self._alive) >= self.maxthreads:
raise IOError("can't create more than %d threads." %
(self.maxthreads,))
thread = self._newthread()
return thread.send((func, args, kwargs))
def _newthread(self):
thread = WorkerThread(self)
self._alive[thread] = True
thread.start()
return thread
def shutdown(self):
""" signal all worker threads to terminate.
call join() to wait until all threads termination.
"""
if not self._shuttingdown:
self._shuttingdown = True
for t in self._alive.keys():
t.stop()
def join(self, timeout=None):
""" wait until all worker threads have terminated. """
current = threading.currentThread()
deadline = delta = None
if timeout is not None:
deadline = time.time() + timeout
for thread in self._alive.keys():
if deadline:
delta = deadline - time.time()
if delta <= 0:
raise IOError("timeout while joining threads")
thread.join(timeout=delta)
if thread.isAlive():
raise IOError("timeout while joining threads")
class NamedThreadPool:
def __init__(self, **kw):
self._namedthreads = {}
for name, value in kw.items():
self.start(name, value)
def __repr__(self):
return "<NamedThreadPool %r>" %(self._namedthreads)
def get(self, name=None):
if name is None:
l = []
for x in self._namedthreads.values():
l.extend(x)
return l
else:
return self._namedthreads.get(name, [])
def getstarted(self, name=None):
return [t for t in self.get(name) if t.isAlive()]
def prunestopped(self, name=None):
if name is None:
for name in self.names():
self.prunestopped(name)
else:
self._namedthreads[name] = self.getstarted(name)
def names(self):
return self._namedthreads.keys()
def start(self, name, func):
l = self._namedthreads.setdefault(name, [])
thread = threading.Thread(name="%s%d" % (name, len(l)),
target=func)
thread.start()
l.append(thread)

View File

@@ -0,0 +1 @@
#

View File

@@ -0,0 +1,66 @@
import py
import sys
WorkerPool = py._thread.WorkerPool
ThreadOut = py._thread.ThreadOut
def test_threadout_install_deinstall():
old = sys.stdout
out = ThreadOut(sys, 'stdout')
out.deinstall()
assert old == sys.stdout
class TestThreadOut:
def setup_method(self, method):
self.out = ThreadOut(sys, 'stdout')
def teardown_method(self, method):
self.out.deinstall()
def test_threadout_one(self):
l = []
self.out.setwritefunc(l.append)
print 42,13,
x = l.pop(0)
assert x == '42'
x = l.pop(0)
assert x == ' '
x = l.pop(0)
assert x == '13'
def test_threadout_multi_and_default(self):
num = 3
defaults = []
def f(l):
self.out.setwritefunc(l.append)
print id(l),
self.out.delwritefunc()
print 1
self.out.setdefaultwriter(defaults.append)
pool = WorkerPool()
listlist = []
for x in range(num):
l = []
listlist.append(l)
pool.dispatch(f, l)
pool.shutdown()
for name, value in self.out.__dict__.items():
print >>sys.stderr, "%s: %s" %(name, value)
pool.join(2.0)
for i in range(num):
item = listlist[i]
assert item ==[str(id(item))]
assert not self.out._tid2out
assert defaults
expect = ['1' for x in range(num)]
defaults = [x for x in defaults if x.strip()]
assert defaults == expect
def test_threadout_nested(self):
# we want ThreadOuts to coexist
last = sys.stdout
out = ThreadOut(sys, 'stdout')
assert last == sys.stdout
out.deinstall()
assert last == sys.stdout

View File

@@ -0,0 +1,93 @@
import py
import sys
WorkerPool = py._thread.WorkerPool
ThreadOut = py._thread.ThreadOut
def test_some():
pool = WorkerPool()
q = py.std.Queue.Queue()
num = 4
def f(i):
q.put(i)
while q.qsize():
py.std.time.sleep(0.01)
for i in range(num):
pool.dispatch(f, i)
for i in range(num):
q.get()
assert len(pool._alive) == 4
pool.shutdown()
# XXX I replaced the following join() with a time.sleep(1), which seems
# to fix the test on Windows, and doesn't break it on Linux... Completely
# unsure what the idea is, though, so it would be nice if someone with some
# more understanding of what happens here would either fix this better, or
# remove this comment...
# pool.join(timeout=1.0)
py.std.time.sleep(1)
assert len(pool._alive) == 0
assert len(pool._ready) == 0
def test_get():
pool = WorkerPool()
def f():
return 42
reply = pool.dispatch(f)
result = reply.get()
assert result == 42
def test_get_timeout():
pool = WorkerPool()
def f():
py.std.time.sleep(0.2)
return 42
reply = pool.dispatch(f)
py.test.raises(IOError, "reply.get(timeout=0.01)")
def test_get_excinfo():
pool = WorkerPool()
def f():
raise ValueError("42")
reply = pool.dispatch(f)
excinfo = py.test.raises(ValueError, "reply.get(1.0)")
py.test.raises(EOFError, "reply.get(1.0)")
def test_maxthreads():
pool = WorkerPool(maxthreads=1)
def f():
py.std.time.sleep(0.5)
try:
pool.dispatch(f)
py.test.raises(IOError, pool.dispatch, f)
finally:
pool.shutdown()
def test_join_timeout():
pool = WorkerPool()
q = py.std.Queue.Queue()
def f():
q.get()
reply = pool.dispatch(f)
pool.shutdown()
py.test.raises(IOError, pool.join, 0.01)
q.put(None)
reply.get(timeout=1.0)
pool.join(timeout=0.1)
def test_pool_clean_shutdown():
capture = py.io.OutErrCapture()
pool = WorkerPool()
def f():
pass
pool.dispatch(f)
pool.dispatch(f)
pool.shutdown()
pool.join(timeout=1.0)
assert not pool._alive
assert not pool._ready
out, err = capture.reset()
print out
print >>sys.stderr, err
assert err == ''