prepare 6.13.0 release (#142)

Author: LaunchDarklyCI

.circleci/config.yml

@@ -171,7 +171,7 @@ jobs:
             pip install -r consul-requirements.txt
             python setup.py install
       - run:
-          name: run tests (2.7)
+          name: run tests
           command: |
             mkdir test-reports
             $env:Path += ";C:\Python27\;C:\Python27\Scripts\"  # has no effect if 2.7 isn't installed

ldclient/__init__.py

@@ -122,6 +122,20 @@ def get():
         __lock.unlock()
 
 
+# for testing only
+def _reset_client():
+    global __client
+    global __lock
+    try:
+        __lock.lock()
+        c = __client
+        __client = None
+    finally:
+        __lock.unlock()
+    if c:
+        c.close()
+
+
 # currently hidden from documentation - see docs/README.md
 class NullHandler(logging.Handler):
     """A :class:`logging.Handler` implementation that does nothing.

ldclient/config.py

@@ -11,6 +11,71 @@
 STREAM_FLAGS_PATH = '/flags'
 
 
+class HTTPConfig(object):
+    """Advanced HTTP configuration options for the SDK client.
+
+    This class groups together HTTP/HTTPS-related configuration properties that rarely need to be changed.
+    If you need to set these, construct an `HTTPConfig` instance and pass it as the `http` parameter when
+    you construct the main :class:`Config` for the SDK client.
+
+    For some of these properties, :class:`Config` also has properties with the same names; the latter are
+    deprecated and will be removed in the future, and if you specify an `HTTPConfig` instance then the
+    corresponding `Config` properties will be ignored.
+    """
+    def __init__(self,
+                 connect_timeout=10,
+                 read_timeout=15,
+                 http_proxy=None,
+                 ca_certs=None,
+                 cert_file=None,
+                 disable_ssl_verification=False):
+        """
+        :param float connect_timeout: The connect timeout for network connections in seconds.
+        :param float read_timeout: The read timeout for network connections in seconds.
+        :param http_proxy: Use a proxy when connecting to LaunchDarkly. This is the full URI of the
+          proxy; for example: http://my-proxy.com:1234. Note that unlike the standard `http_proxy` environment
+          variable, this is used regardless of whether the target URI is HTTP or HTTPS (the actual LaunchDarkly
+          service uses HTTPS, but a Relay Proxy instance could use HTTP). Setting this Config parameter will
+          override any proxy specified by an environment variable, but only for LaunchDarkly SDK connections.
+        :param string ca_certs: If using a custom certificate authority, set this to the file path of the
+          certificate bundle.
+        :param string cert_file: If using a custom client certificate, set this to the file path of the
+          certificate.
+        :param bool disable_ssl_verification: If true, completely disables SSL verification and certificate
+          verification for secure requests. This is unsafe and should not be used in a production environment;
+          instead, use a self-signed certificate and set `ca_certs`.
+        """
+        self.__connect_timeout = connect_timeout
+        self.__read_timeout = read_timeout
+        self.__http_proxy = http_proxy
+        self.__ca_certs = ca_certs
+        self.__cert_file = cert_file
+        self.__disable_ssl_verification = disable_ssl_verification
+
+    @property
+    def connect_timeout(self):
+        return self.__connect_timeout
+
+    @property
+    def read_timeout(self):
+        return self.__read_timeout
+
+    @property
+    def http_proxy(self):
+        return self.__http_proxy
+
+    @property
+    def ca_certs(self):
+        return self.__ca_certs
+
+    @property
+    def cert_file(self):
+        return self.__cert_file
+
+    @property
+    def disable_ssl_verification(self):
+        return self.__disable_ssl_verification
+
 class Config(object):
     """Advanced configuration options for the SDK client.
 
@@ -27,6 +92,7 @@ def __init__(self,
                  flush_interval=5,
                  stream_uri='https://stream.launchdarkly.com',
                  stream=True,
+                 initial_reconnect_delay=1,
                  verify_ssl=True,
                  defaults=None,
                  send_events=None,
@@ -47,15 +113,18 @@ def __init__(self,
                  diagnostic_opt_out=False,
                  diagnostic_recording_interval=900,
                  wrapper_name=None,
-                 wrapper_version=None):
+                 wrapper_version=None,
+                 http=None):
         """
         :param string sdk_key: The SDK key for your LaunchDarkly account.
         :param string base_uri: The base URL for the LaunchDarkly server. Most users should use the default
           value.
         :param string events_uri: The URL for the LaunchDarkly events server. Most users should use the
           default value.
-        :param float connect_timeout: The connect timeout for network connections in seconds.
-        :param float read_timeout: The read timeout for network connections in seconds.
+        :param float connect_timeout: Deprecated; use `http` instead and specify the `connect_timeout` as
+          part of :class:`HTTPConfig`.
+        :param float read_timeout: Deprecated; use `http` instead and specify the `read_timeout` as
+          part of :class:`HTTPConfig`.
         :param int events_upload_max_batch_size: The maximum number of analytics events that the client will
           send at once.
         :param int events_max_pending: The capacity of the events buffer. The client buffers up to this many
@@ -67,6 +136,12 @@ def __init__(self,
           use the default value.
         :param bool stream: Whether or not the streaming API should be used to receive flag updates. By
           default, it is enabled. Streaming should only be disabled on the advice of LaunchDarkly support.
+        :param float initial_reconnect_delay: The initial reconnect delay (in seconds) for the streaming
+          connection. The streaming service uses a backoff algorithm (with jitter) every time the connection needs
+          to be reestablished. The delay for the first reconnection will start near this value, and then
+          increase exponentially for any subsequent connection failures.
+        :param bool verify_ssl:  Deprecated; use `http` instead and specify `disable_ssl_verification` as
+          part of :class:`HTTPConfig` if you want to turn off SSL verification (not recommended).
         :param bool send_events: Whether or not to send events back to LaunchDarkly. This differs from
           `offline` in that it affects only the sending of client-side events, not streaming or polling for
           events from the server. By default, events will be sent.
@@ -99,11 +174,8 @@ def __init__(self,
         :type event_processor_class: (ldclient.config.Config) -> EventProcessor
         :param update_processor_class: A factory for an UpdateProcessor implementation taking the sdk key,
           config, and FeatureStore implementation
-        :param http_proxy: Use a proxy when connecting to LaunchDarkly. This is the full URI of the
-          proxy; for example: http://my-proxy.com:1234. Note that unlike the standard `http_proxy` environment
-          variable, this is used regardless of whether the target URI is HTTP or HTTPS (the actual LaunchDarkly
-          service uses HTTPS, but a Relay Proxy instance could use HTTP). Setting this Config parameter will
-          override any proxy specified by an environment variable, but only for LaunchDarkly SDK connections.
+        :param http_proxy:  Deprecated; use `http` instead and specify the `http_proxy` as part of
+          :class:`HTTPConfig`.
         :param bool diagnostic_opt_out: Unless this field is set to True, the client will send
           some diagnostics data to the LaunchDarkly servers in order to assist in the development of future SDK
           improvements. These diagnostics consist of an initial payload containing some details of SDK in use,
@@ -118,6 +190,8 @@ def __init__(self,
           use. If `wrapper_name` is not set, this field will be ignored. Otherwise the version string will
           be included in the HTTP headers along with the `wrapper_name` during requests to the LaunchDarkly
           servers.
+        :param HTTPConfig http: Optional properties for customizing the client's HTTP/HTTPS behavior. See
+          :class:`HTTPConfig`.
         """
         self.__sdk_key = sdk_key
 
@@ -129,6 +203,7 @@ def __init__(self,
         self.__stream_uri = stream_uri.rstrip('\\')
         self.__update_processor_class = update_processor_class
         self.__stream = stream
+        self.__initial_reconnect_delay = initial_reconnect_delay
         self.__poll_interval = max(poll_interval, 30)
         self.__use_ldd = use_ldd
         self.__feature_store = InMemoryFeatureStore() if not feature_store else feature_store
@@ -154,6 +229,7 @@ def __init__(self,
         self.__diagnostic_recording_interval = max(diagnostic_recording_interval, 60)
         self.__wrapper_name = wrapper_name
         self.__wrapper_version = wrapper_version
+        self.__http = http
 
     @classmethod
     def default(cls):
@@ -178,6 +254,7 @@ def copy_with_new_sdk_key(self, new_sdk_key):
                       flush_interval=self.__flush_interval,
                       stream_uri=self.__stream_uri,
                       stream=self.__stream,
+                      initial_reconnect_delay=self.__initial_reconnect_delay,
                       verify_ssl=self.__verify_ssl,
                       defaults=self.__defaults,
                       send_events=self.__send_events,
@@ -196,7 +273,8 @@ def copy_with_new_sdk_key(self, new_sdk_key):
                       diagnostic_opt_out=self.__diagnostic_opt_out,
                       diagnostic_recording_interval=self.__diagnostic_recording_interval,
                       wrapper_name=self.__wrapper_name,
-                      wrapper_version=self.__wrapper_version)
+                      wrapper_version=self.__wrapper_version,
+                      http=self.__http)
 
     # for internal use only - probably should be part of the client logic
     def get_default(self, key, default):
@@ -244,6 +322,9 @@ def stream(self):
         return self.__stream
 
     @property
+    def initial_reconnect_delay(self):
+        return self.__initial_reconnect_delay
+    @property
     def poll_interval(self):
         return self.__poll_interval
 
@@ -335,6 +416,19 @@ def wrapper_name(self):
     def wrapper_version(self):
         return self.__wrapper_version
 
+    @property
+    def http(self):
+        if self.__http is None:
+            return HTTPConfig(
+                connect_timeout=self.__connect_timeout,
+                read_timeout=self.__read_timeout,
+                http_proxy=self.__http_proxy,
+                ca_certs=None,
+                cert_file=None,
+                disable_ssl_verification=not self.__verify_ssl
+            )
+        return self.__http
+    
     def _validate(self):
         if self.offline is False and self.sdk_key is None or self.sdk_key == '':
             log.warning("Missing or blank sdk_key.")

ldclient/event_processor.py

@@ -22,13 +22,13 @@
 
 from ldclient.event_summarizer import EventSummarizer
 from ldclient.fixed_thread_pool import FixedThreadPool
+from ldclient.impl.http import _http_factory
 from ldclient.lru_cache import SimpleLRUCache
 from ldclient.user_filter import UserFilter
 from ldclient.interfaces import EventProcessor
 from ldclient.repeating_timer import RepeatingTimer
 from ldclient.util import UnsuccessfulResponseException
 from ldclient.util import _headers, _retryable_statuses
-from ldclient.util import create_http_pool_manager
 from ldclient.util import log
 from ldclient.util import http_error_message, is_http_error_recoverable, stringify_attrs, throw_if_unsuccessful_response
 from ldclient.diagnostics import create_diagnostic_init
@@ -255,8 +255,7 @@ class EventDispatcher(object):
     def __init__(self, inbox, config, http_client, diagnostic_accumulator=None):
         self._inbox = inbox
         self._config = config
-        self._http = create_http_pool_manager(num_pools=1, verify_ssl=config.verify_ssl,
-            target_base_uri=config.events_uri, force_proxy=config.http_proxy) if http_client is None else http_client
+        self._http = _http_factory(config).create_pool_manager(1, config.events_uri) if http_client is None else http_client
         self._close_http = (http_client is None)  # so we know whether to close it later
         self._disabled = False
         self._outbox = EventBuffer(config.events_max_pending)

ldclient/feature_requester.py

@@ -7,10 +7,10 @@
 import json
 import urllib3
 
+from ldclient.impl.http import _http_factory
 from ldclient.interfaces import FeatureRequester
 from ldclient.util import UnsuccessfulResponseException
 from ldclient.util import _headers
-from ldclient.util import create_http_pool_manager
 from ldclient.util import log
 from ldclient.util import throw_if_unsuccessful_response
 from ldclient.versioned_data_kind import FEATURES, SEGMENTS
@@ -25,8 +25,7 @@
 class FeatureRequesterImpl(FeatureRequester):
     def __init__(self, config):
         self._cache = dict()
-        self._http = create_http_pool_manager(num_pools=1, verify_ssl=config.verify_ssl,
-            target_base_uri=config.base_uri, force_proxy=config.http_proxy)
+        self._http = _http_factory(config).create_pool_manager(1, config.base_uri)
         self._config = config
 
     def get_all_data(self):

ldclient/impl/http.py

@@ -0,0 +1,70 @@
+from ldclient.version import VERSION
+import certifi
+from os import environ
+import urllib3
+
+def _base_headers(config):
+    headers = {'Authorization': config.sdk_key or '',
+               'User-Agent': 'PythonClient/' + VERSION}
+    if isinstance(config.wrapper_name, str) and config.wrapper_name != "":
+        wrapper_version = ""
+        if isinstance(config.wrapper_version, str) and config.wrapper_version != "":
+            wrapper_version = "/" + config.wrapper_version
+        headers.update({'X-LaunchDarkly-Wrapper': config.wrapper_name + wrapper_version})
+    return headers
+
+def _http_factory(config):
+    return HTTPFactory(_base_headers(config), config.http)
+
+class HTTPFactory(object):
+    def __init__(self, base_headers, http_config, override_read_timeout=None):
+        self.__base_headers = base_headers
+        self.__http_config = http_config
+        self.__timeout = urllib3.Timeout(
+            connect=http_config.connect_timeout,
+            read=http_config.read_timeout if override_read_timeout is None else override_read_timeout
+        )
+    
+    @property
+    def base_headers(self):
+        return self.__base_headers
+    
+    @property
+    def http_config(self):
+        return self.__http_config
+    
+    @property
+    def timeout(self):
+        return self.__timeout
+    
+    def create_pool_manager(self, num_pools, target_base_uri):
+        proxy_url = self.__http_config.http_proxy or _get_proxy_url(target_base_uri)
+
+        if self.__http_config.disable_ssl_verification:
+            cert_reqs = 'CERT_NONE'
+            ca_certs = None
+        else:
+            cert_reqs = 'CERT_REQUIRED'
+            ca_certs = self.__http_config.ca_certs or certifi.where()
+
+        if proxy_url is None:
+            return urllib3.PoolManager(
+                num_pools=num_pools,
+                cert_reqs=cert_reqs,
+                ca_certs=ca_certs
+                )
+        else:
+            return urllib3.ProxyManager(
+                proxy_url,
+                num_pools=num_pools,
+                cert_reqs=cert_reqs,
+                ca_certs = ca_certs
+            )
+
+def _get_proxy_url(target_base_uri):
+    if target_base_uri is None:
+        return None
+    is_https = target_base_uri.startswith('https:')
+    if is_https:
+        return environ.get('https_proxy')
+    return environ.get('http_proxy')