Expose a non-thread-local base client class

This allows more advanced client pooling mechanisms to be used.

Author: hyperair

memcache.py

@@ -106,8 +106,10 @@ class _ConnectionDeadError(Exception):
 _SOCKET_TIMEOUT = 3  # number of seconds before sockets timeout.
 
 
-class Client(threading.local):
-    """Object representing a pool of memcache servers.
+class BasicClient(object):
+    """Object representing a pool of memcache servers. This is not thread-safe,
+    and should either be wrapped in a thread-local variable or other
+    synchronizing mechanism.
 
     See L{memcache} for an overview.
 
@@ -1500,6 +1502,14 @@ def __str__(self):
             return "unix:%s%s" % (self.address, d)
 
 
+class Client(BasicClient, threading.local):
+    """
+    Thread-safe memcache client. See L{BasicClient} for more information on how
+    to use this class.
+    """
+    pass
+
+
 def _doctest():
     import doctest
     import memcache