Add polling + indirect support for streaming

CONTRIBUTING.md

@@ -18,6 +18,6 @@ Development information (for developing this module itself)
         pip install -r test-requirements.txt
         pip install -r twisted-requirements.txt
 
-1. Run tests:
+1. Run tests: You'll need redis running locally on its default port of 6379.
 
         $ py.test testing

README.md

@@ -13,9 +13,14 @@ Quick setup
 
         pip install ldclient-py
 
-2. Create a new LDClient with your API key:
+2. Configure the library with your api key:
 
-        client = LDClient("your_api_key")
+        import ldclient
+        ldclient.api_key = "your api key"
+
+3. Get the client:
+
+        client = ldclient.get()
 
 Your first feature flag
 -----------------------

circle.yml

@@ -1,3 +1,6 @@
+machine:
+  services:
+    - redis
 dependencies:
   pre:
     - pyenv shell 2.7.10; $(pyenv which pip) install --upgrade pip setuptools

demo/demo.py

@@ -1,7 +1,25 @@
 from __future__ import print_function
-from ldclient import LDClient
+
+import logging
+import sys
+
+import ldclient
+
+root = logging.getLogger()
+root.setLevel(logging.DEBUG)
+
+ch = logging.StreamHandler(sys.stdout)
+ch.setLevel(logging.DEBUG)
+formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s')
+ch.setFormatter(formatter)
+root.addHandler(ch)
 
 if __name__ == '__main__':
-    apiKey = 'feefifofum'
-    client = LDClient(apiKey)
-    print(client.api_key)
+    ldclient._api_key = 'api_key'
+    ldclient.start_wait = 10
+    client = ldclient.get()
+
+    user = {u'key': 'userKey'}
+    print(client.toggle("update-app", user, False))
+
+    client.close()

ldclient/__init__.py

@@ -1,7 +1,9 @@
-from .client import *
+import logging
+
+from ldclient.rwlock import ReadWriteLock
 from ldclient.version import VERSION
+from .client import *
 from .util import log
-import logging
 
 __version__ = VERSION
 
@@ -11,6 +13,34 @@
                 "firstName", "lastName", "avatar", "name", "anonymous"]
 
 
+"""Settings."""
+client = None
+api_key = None
+start_wait = 5
+config = Config()
+
+_lock = ReadWriteLock()
+
+
+def get():
+    try:
+        _lock.rlock()
+        if client:
+            return client
+    finally:
+        _lock.runlock()
+
+    try:
+        global client
+        _lock.lock()
+        if not client:
+            log.debug("Initializing LaunchDarkly Client")
+            client = LDClient(api_key, config, start_wait)
+        return client
+    finally:
+        _lock.unlock()
+
+
 # Add a NullHandler for Python < 2.7 compatibility
 class NullHandler(logging.Handler):