splitio-client 9.6.2__tar.gz → 10.0.0__tar.gz

splitio_client-10.0.0/PKG-INFO

@@ -0,0 +1,100 @@
+Metadata-Version: 2.1
+Name: splitio_client
+Version: 10.0.0
+Summary: Split.io Python Client
+Home-page: https://github.com/splitio/python-client
+Author: Patricio Echague, Sebastian Arrubia
+Author-email: pato@split.io, sebastian@split.io
+License: Apache License 2.0
+Download-URL: https://github.com/splitio/python-client/tarball/10.0.0
+Description: # Split Python SDK
+        ![Build Status](https://github.com/splitio/python-client/actions/workflows/ci.yml/badge.svg?branch=master)
+        
+        ## Overview
+        This SDK is designed to work with Split, the platform for controlled rollouts, which serves features to your users via a Split feature flag to manage your complete customer experience.
+        
+        [![Twitter Follow](https://img.shields.io/twitter/follow/splitsoftware.svg?style=social&label=Follow&maxAge=1529000)](https://twitter.com/intent/follow?screen_name=splitsoftware)
+        
+        ## Compatibility
+        This SDK is compatible with **Python 3.7 and higher**.
+        
+        ## Getting started
+        Below is a simple example that describes the instantiation and most basic usage of our SDK:
+        
+        Run `pip install splitio_client`
+        
+        
+        ```python
+        from splitio import get_factory
+        from splitio.exceptions import TimeoutException
+        factory = get_factory('YOUR_SDK_TYPE_API_KEY', config=config)
+        try:
+            factory.block_until_ready(5) # wait up to 5 seconds
+            split = factory.client()
+            treatment = split.get_treatment('CUSTOMER_ID', 'FEATURE_FLAG_NAME')
+            if treatment == "on":
+                # insert code here to show on treatment
+            elif treatment == "off":
+                # insert code here to show off treatment
+            else:
+                # insert your control treatment code here
+        except TimeoutException:
+            # Now the user can choose whether to abort the whole execution, or just keep going
+            # without a ready client, which if configured properly, should become ready at some point.
+            pass
+        ```
+        
+        Please refer to [our official docs](https://help.split.io/hc/en-us/articles/360020359652-Python-SDK) to learn about all the functionality provided by our SDK and the configuration options available for tailoring it to your current application setup.
+        
+        ## Submitting issues
+        The Split team monitors all issues submitted to this [issue tracker](https://github.com/splitio/python-client/issues). We encourage you to use this issue tracker to submit any bug reports, feedback, and feature enhancements. We'll do our best to respond in a timely manner.
+        
+        ## Contributing
+        Please see [Contributors Guide](CONTRIBUTORS-GUIDE.md) to find all you need to submit a Pull Request (PR).
+        
+        ## License
+        Licensed under the Apache License, Version 2.0. See: [Apache License](http://www.apache.org/licenses/).
+        
+        ## About Split
+        
+        Split is the leading Feature Delivery Platform for engineering teams that want to confidently deploy features as fast as they can develop them. Split’s fine-grained management, real-time monitoring, and data-driven experimentation ensure that new features will improve the customer experience without breaking or degrading performance. Companies like Twilio, Salesforce, GoDaddy and WePay trust Split to power their feature delivery.
+        
+        To learn more about Split, contact hello@split.io, or get started with feature flags for free at https://www.split.io/signup.
+        
+        Split has built and maintains SDKs for:
+        
+        * .NET [Github](https://github.com/splitio/dotnet-client) [Docs](https://help.split.io/hc/en-us/articles/360020240172--NET-SDK)
+        * Android [Github](https://github.com/splitio/android-client) [Docs](https://help.split.io/hc/en-us/articles/360020343291-Android-SDK)
+        * Angular [Github](https://github.com/splitio/angular-sdk-plugin) [Docs](https://help.split.io/hc/en-us/articles/6495326064397-Angular-utilities)
+        * GO [Github](https://github.com/splitio/go-client) [Docs](https://help.split.io/hc/en-us/articles/360020093652-Go-SDK)
+        * iOS [Github](https://github.com/splitio/ios-client) [Docs](https://help.split.io/hc/en-us/articles/360020401491-iOS-SDK)
+        * Java [Github](https://github.com/splitio/java-client) [Docs](https://help.split.io/hc/en-us/articles/360020405151-Java-SDK)
+        * JavaScript [Github](https://github.com/splitio/javascript-client) [Docs](https://help.split.io/hc/en-us/articles/360020448791-JavaScript-SDK)
+        * JavaScript for Browser [Github](https://github.com/splitio/javascript-browser-client) [Docs](https://help.split.io/hc/en-us/articles/360058730852-Browser-SDK)
+        * Node [Github](https://github.com/splitio/javascript-client) [Docs](https://help.split.io/hc/en-us/articles/360020564931-Node-js-SDK)
+        * PHP [Github](https://github.com/splitio/php-client) [Docs](https://help.split.io/hc/en-us/articles/360020350372-PHP-SDK)
+        * Python [Github](https://github.com/splitio/python-client) [Docs](https://help.split.io/hc/en-us/articles/360020359652-Python-SDK)
+        * React [Github](https://github.com/splitio/react-client) [Docs](https://help.split.io/hc/en-us/articles/360038825091-React-SDK)
+        * React Native [Github](https://github.com/splitio/react-native-client) [Docs](https://help.split.io/hc/en-us/articles/4406066357901-React-Native-SDK)
+        * Redux [Github](https://github.com/splitio/redux-client) [Docs](https://help.split.io/hc/en-us/articles/360038851551-Redux-SDK)
+        * Ruby [Github](https://github.com/splitio/ruby-client) [Docs](https://help.split.io/hc/en-us/articles/360020673251-Ruby-SDK)
+        
+        For a comprehensive list of open source projects visit our [Github page](https://github.com/splitio?utf8=%E2%9C%93&query=%20only%3Apublic%20).
+        
+        **Learn more about Split:**
+        
+        Visit [split.io/product](https://www.split.io/product) for an overview of Split, or visit our documentation at [help.split.io](http://help.split.io) for more detailed information.
+        
+Platform: UNKNOWN
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 2
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development :: Libraries
+Description-Content-Type: text/markdown
+Provides-Extra: test
+Provides-Extra: redis
+Provides-Extra: uwsgi
+Provides-Extra: cpphash
+Provides-Extra: asyncio

{splitio_client-9.6.2 → splitio_client-10.0.0}/README.md

@@ -7,7 +7,7 @@ This SDK is designed to work with Split, the platform for controlled rollouts, w
 [![Twitter Follow](https://img.shields.io/twitter/follow/splitsoftware.svg?style=social&label=Follow&maxAge=1529000)](https://twitter.com/intent/follow?screen_name=splitsoftware)
 
 ## Compatibility
-This SDK is compatible with **Python 3 and higher**.
+This SDK is compatible with **Python 3.7 and higher**.
 
 ## Getting started
 Below is a simple example that describes the instantiation and most basic usage of our SDK:

{splitio_client-9.6.2 → splitio_client-10.0.0}/setup.cfg

@@ -2,7 +2,10 @@
 universal = 1
 
 [metadata]
-description-file = README.md
+name = splitio_client
+description = This SDK is designed to work with Split, the platform for controlled rollouts, which serves features to your users via a Split feature flag to manage your complete customer experience.
+long_description = file: README.md
+long_description_content_type = text/markdown
 
 [flake8]
 max-line-length = 100
@@ -12,7 +15,6 @@ exclude = tests/*
 test = pytest
 
 [tool:pytest]
-ignore_glob = ./splitio/_OLD/*
 addopts = --verbose --cov=splitio --cov-report xml
 python_classes = *Tests
 

{splitio_client-9.6.2 → splitio_client-10.0.0}/setup.py

@@ -7,18 +7,21 @@ from setuptools import setup, find_packages
 TESTS_REQUIRES = [
     'flake8',
     'pytest==7.0.1',
-    'pytest-mock==3.12.0',
-    'coverage==6.2',
-    'pytest-cov',
-    'importlib-metadata==4.2',
+    'pytest-mock==3.11.1',
+    'coverage',
+    'pytest-cov==4.1.0',
+    'importlib-metadata==6.7',
     'tomli==1.2.3',
     'iniconfig==1.1.1',
-    'attrs==22.1.0'
+    'attrs==22.1.0',
+    'pytest-asyncio==0.21.0',
+    'aiohttp>=3.8.4',
+    'aiofiles>=23.1.0'
 ]
 
 INSTALL_REQUIRES = [
-    'requests>=2.9.1',
-    'pyyaml>=5.4',
+    'requests',
+    'pyyaml',
     'docopt>=0.6.2',
     'enum34;python_version<"3.4"',
     'bloom-filter2>=2.0.0'
@@ -43,8 +46,9 @@ setup(
         'redis': ['redis>=2.10.5'],
         'uwsgi': ['uwsgi>=2.0.0'],
         'cpphash': ['mmh3cffi==0.2.1'],
+        'asyncio': ['aiohttp>=3.8.4', 'aiofiles>=23.1.0']
     },
-    setup_requires=['pytest-runner', 'pluggy==1.0.0;python_version<"3.7"'],
+    setup_requires=['pytest-runner', 'pluggy==1.0.0;python_version<"3.8"'],
     classifiers=[
         'Environment :: Console',
         'Intended Audience :: Developers',

{splitio_client-9.6.2 → splitio_client-10.0.0}/splitio/__init__.py

@@ -1,3 +1,3 @@
-from splitio.client.factory import get_factory
+from splitio.client.factory import get_factory, get_factory_async
 from splitio.client.key import Key
 from splitio.version import __version__

splitio_client-10.0.0/splitio/api/__init__.py

@@ -0,0 +1,46 @@
+"""Split API module."""
+
+
+class APIException(Exception):
+    """Exception to raise when an API call fails."""
+
+    def __init__(self, custom_message, status_code=None):
+        """Constructor."""
+        Exception.__init__(self, custom_message)
+        self._status_code = status_code if status_code else -1
+
+    @property
+    def status_code(self):
+        """Return HTTP status code."""
+        return self._status_code
+
+class APIUriException(APIException):
+    """Exception to raise when an API call fails due to 414  http error."""
+
+    def __init__(self, custom_message, status_code=None):
+        """Constructor."""
+        APIException.__init__(self, custom_message, status_code)
+
+def headers_from_metadata(sdk_metadata, client_key=None):
+    """
+    Generate a dict with headers required by data-recording API endpoints.
+    :param sdk_metadata: SDK Metadata object, generated at sdk initialization time.
+    :type sdk_metadata: splitio.client.util.SdkMetadata
+    :param client_key: client key.
+    :type client_key: str
+    :return: A dictionary with headers.
+    :rtype: dict
+    """
+
+    metadata = {
+        'SplitSDKVersion': sdk_metadata.sdk_version,
+        'SplitSDKMachineIP': sdk_metadata.instance_ip,
+        'SplitSDKMachineName': sdk_metadata.instance_name
+    } if sdk_metadata.instance_ip != 'NA' and sdk_metadata.instance_ip != 'unknown' else {
+        'SplitSDKVersion': sdk_metadata.sdk_version,
+    }
+
+    if client_key is not None:
+        metadata['SplitSDKClientKey'] = client_key
+
+    return metadata

splitio_client-10.0.0/splitio/api/auth.py

@@ -0,0 +1,109 @@
+"""Auth API module."""
+
+import logging
+import json
+
+from splitio.api import APIException, headers_from_metadata
+from splitio.api.commons import headers_from_metadata, record_telemetry
+from splitio.spec import SPEC_VERSION
+from splitio.util.time import get_current_epoch_time_ms
+from splitio.api.client import HttpClientException
+from splitio.models.token import from_raw
+from splitio.models.telemetry import HTTPExceptionsAndLatencies
+
+_LOGGER = logging.getLogger(__name__)
+
+
+class AuthAPI(object):  # pylint: disable=too-few-public-methods
+    """Class that uses an httpClient to communicate with the SDK Auth Service API."""
+
+    def __init__(self, client, sdk_key, sdk_metadata, telemetry_runtime_producer):
+        """
+        Class constructor.
+
+        :param client: HTTP Client responsble for issuing calls to the backend.
+        :type client: HttpClient
+        :param sdk_key: User sdk key.
+        :type sdk_key: string
+        :param sdk_metadata: SDK version & machine name & IP.
+        :type sdk_metadata: splitio.client.util.SdkMetadata
+        """
+        self._client = client
+        self._sdk_key = sdk_key
+        self._metadata = headers_from_metadata(sdk_metadata)
+        self._telemetry_runtime_producer = telemetry_runtime_producer
+        self._client.set_telemetry_data(HTTPExceptionsAndLatencies.TOKEN, self._telemetry_runtime_producer)
+
+    def authenticate(self):
+        """
+        Perform authentication.
+
+        :return: Json representation of an authentication.
+        :rtype: splitio.models.token.Token
+        """
+        try:
+            response = self._client.get(
+                'auth',
+                'v2/auth?s=' + SPEC_VERSION,
+                self._sdk_key,
+                extra_headers=self._metadata,
+            )
+            if 200 <= response.status_code < 300:
+                payload = json.loads(response.body)
+                return from_raw(payload)
+
+            else:
+                if (response.status_code >= 400 and response.status_code < 500):
+                    self._telemetry_runtime_producer.record_auth_rejections()
+                raise APIException(response.body, response.status_code)
+        except HttpClientException as exc:
+            _LOGGER.error('Exception raised while authenticating')
+            _LOGGER.debug('Exception information: ', exc_info=True)
+            raise APIException('Could not perform authentication.') from exc
+
+class AuthAPIAsync(object):  # pylint: disable=too-few-public-methods
+    """Async Class that uses an httpClient to communicate with the SDK Auth Service API."""
+
+    def __init__(self, client, sdk_key, sdk_metadata, telemetry_runtime_producer):
+        """
+        Class constructor.
+
+        :param client: HTTP Client responsble for issuing calls to the backend.
+        :type client: HttpClient
+        :param sdk_key: User sdk key.
+        :type sdk_key: string
+        :param sdk_metadata: SDK version & machine name & IP.
+        :type sdk_metadata: splitio.client.util.SdkMetadata
+        """
+        self._client = client
+        self._sdk_key = sdk_key
+        self._metadata = headers_from_metadata(sdk_metadata)
+        self._telemetry_runtime_producer = telemetry_runtime_producer
+        self._client.set_telemetry_data(HTTPExceptionsAndLatencies.TOKEN, self._telemetry_runtime_producer)
+
+    async def authenticate(self):
+        """
+        Perform authentication.
+
+        :return: Json representation of an authentication.
+        :rtype: splitio.models.token.Token
+        """
+        try:
+            response = await self._client.get(
+                'auth',
+                'v2/auth?s=' + SPEC_VERSION,
+                self._sdk_key,
+                extra_headers=self._metadata,
+            )
+            if 200 <= response.status_code < 300:
+                payload = json.loads(response.body)
+                return from_raw(payload)
+
+            else:
+                if (response.status_code >= 400 and response.status_code < 500):
+                    await self._telemetry_runtime_producer.record_auth_rejections()
+                raise APIException(response.body, response.status_code)
+        except HttpClientException as exc:
+            _LOGGER.error('Exception raised while authenticating')
+            _LOGGER.debug('Exception information: ', exc_info=True)
+            raise APIException('Could not perform authentication.') from exc

splitio_client-10.0.0/splitio/api/client.py

@@ -0,0 +1,336 @@
+"""Synchronous HTTP Client for split API."""
+from collections import namedtuple
+import requests
+import urllib
+import abc
+import logging
+import json
+
+from splitio.optional.loaders import aiohttp
+from splitio.util.time import get_current_epoch_time_ms
+
+SDK_URL = 'https://sdk.split.io/api'
+EVENTS_URL = 'https://events.split.io/api'
+AUTH_URL = 'https://auth.split.io/api'
+TELEMETRY_URL = 'https://telemetry.split.io/api'
+
+_LOGGER = logging.getLogger(__name__)
+
+
+HttpResponse = namedtuple('HttpResponse', ['status_code', 'body', 'headers'])
+
+def _build_url(server, path, urls):
+    """
+    Build URL according to server specified.
+
+    :param server: Server for whith the request is being made.
+    :type server: str
+    :param path: URL path to be appended to base host.
+    :type path: str
+
+    :return: A fully qualified URL.
+    :rtype: str
+    """
+    url = urls[server]
+    url += '/' if urls[server][:-1] != '/' else ''
+    return urllib.parse.urljoin(url, path)
+
+def _construct_urls(sdk_url=None, events_url=None, auth_url=None, telemetry_url=None):
+    return {
+        'sdk': sdk_url if sdk_url is not None else SDK_URL,
+        'events': events_url if events_url is not None else EVENTS_URL,
+        'auth': auth_url if auth_url is not None else AUTH_URL,
+        'telemetry': telemetry_url if telemetry_url is not None else TELEMETRY_URL,
+    }
+
+def _build_basic_headers(sdk_key):
+    """
+    Build basic headers with auth.
+
+    :param sdk_key: API token used to identify backend calls.
+    :type sdk_key: str
+    """
+    return {
+        'Content-Type': 'application/json',
+        'Authorization': "Bearer %s" % sdk_key
+    }
+
+class HttpClientException(Exception):
+    """HTTP Client exception."""
+
+    def __init__(self, message):
+        """
+        Class constructor.
+
+        :param message: Information on why this exception happened.
+        :type message: str
+        """
+        Exception.__init__(self, message)
+
+class HttpClientBase(object, metaclass=abc.ABCMeta):
+    """HttpClient wrapper template."""
+
+    @abc.abstractmethod
+    def get(self, server, path, apikey):
+        """http get request"""
+
+    @abc.abstractmethod
+    def post(self, server, path, apikey):
+        """http post request"""
+
+    def set_telemetry_data(self, metric_name, telemetry_runtime_producer):
+        """
+        Set the data needed for telemetry call
+
+        :param metric_name: metric name for telemetry
+        :type metric_name: str
+
+        :param telemetry_runtime_producer: telemetry recording instance
+        :type telemetry_runtime_producer: splitio.engine.telemetry.TelemetryRuntimeProducer
+        """
+        self._telemetry_runtime_producer = telemetry_runtime_producer
+        self._metric_name = metric_name
+
+
+class HttpClient(HttpClientBase):
+    """HttpClient wrapper."""
+
+    def __init__(self, timeout=None, sdk_url=None, events_url=None, auth_url=None, telemetry_url=None):
+        """
+        Class constructor.
+
+        :param timeout: How many milliseconds to wait until the server responds.
+        :type timeout: int
+        :param sdk_url: Optional alternative sdk URL.
+        :type sdk_url: str
+        :param events_url: Optional alternative events URL.
+        :type events_url: str
+        :param auth_url: Optional alternative auth URL.
+        :type auth_url: str
+        :param telemetry_url: Optional alternative telemetry URL.
+        :type telemetry_url: str
+        """
+        self._timeout = timeout/1000 if timeout else None # Convert ms to seconds.
+        self._urls = _construct_urls(sdk_url, events_url, auth_url, telemetry_url)
+
+    def get(self, server, path, sdk_key, query=None, extra_headers=None):  # pylint: disable=too-many-arguments
+        """
+        Issue a get request.
+
+        :param server: Whether the request is for SDK server, Events server or Auth server.
+        :typee server: str
+        :param path: path to append to the host url.
+        :type path: str
+        :param sdk_key: sdk key.
+        :type sdk_key: str
+        :param query: Query string passed as dictionary.
+        :type query: dict
+        :param extra_headers: key/value pairs of possible extra headers.
+        :type extra_headers: dict
+
+        :return: Tuple of status_code & response text
+        :rtype: HttpResponse
+        """
+        headers = _build_basic_headers(sdk_key)
+        if extra_headers is not None:
+            headers.update(extra_headers)
+
+        start = get_current_epoch_time_ms()
+        try:
+            response = requests.get(
+                _build_url(server, path, self._urls),
+                params=query,
+                headers=headers,
+                timeout=self._timeout
+            )
+            self._record_telemetry(response.status_code, get_current_epoch_time_ms() - start)
+            return HttpResponse(response.status_code, response.text, response.headers)
+
+        except Exception as exc:  # pylint: disable=broad-except
+            raise HttpClientException('requests library is throwing exceptions') from exc
+
+    def post(self, server, path, sdk_key, body, query=None, extra_headers=None):  # pylint: disable=too-many-arguments
+        """
+        Issue a POST request.
+
+        :param server: Whether the request is for SDK server or Events server.
+        :typee server: str
+        :param path: path to append to the host url.
+        :type path: str
+        :param sdk_key: sdk key.
+        :type sdk_key: str
+        :param body: body sent in the request.
+        :type body: str
+        :param query: Query string passed as dictionary.
+        :type query: dict
+        :param extra_headers: key/value pairs of possible extra headers.
+        :type extra_headers: dict
+
+        :return: Tuple of status_code & response text
+        :rtype: HttpResponse
+        """
+        headers = _build_basic_headers(sdk_key)
+
+        if extra_headers is not None:
+            headers.update(extra_headers)
+
+        start = get_current_epoch_time_ms()
+        try:
+            response = requests.post(
+                _build_url(server, path, self._urls),
+                json=body,
+                params=query,
+                headers=headers,
+                timeout=self._timeout
+            )
+            self._record_telemetry(response.status_code, get_current_epoch_time_ms() - start)
+            return HttpResponse(response.status_code, response.text, response.headers)
+
+        except Exception as exc:  # pylint: disable=broad-except
+            raise HttpClientException('requests library is throwing exceptions') from exc
+
+    def _record_telemetry(self, status_code, elapsed):
+        """
+        Record Telemetry info
+
+        :param status_code: http request status code
+        :type status_code: int
+
+        :param elapsed: response time elapsed.
+        :type status_code: int
+        """
+        self._telemetry_runtime_producer.record_sync_latency(self._metric_name, elapsed)
+        if 200 <= status_code < 300:
+            self._telemetry_runtime_producer.record_successful_sync(self._metric_name, get_current_epoch_time_ms())
+            return
+        self._telemetry_runtime_producer.record_sync_error(self._metric_name, status_code)
+
+
+class HttpClientAsync(HttpClientBase):
+    """HttpClientAsync wrapper."""
+
+    def __init__(self, timeout=None, sdk_url=None, events_url=None, auth_url=None, telemetry_url=None):
+        """
+        Class constructor.
+        :param timeout: How many milliseconds to wait until the server responds.
+        :type timeout: int
+        :param sdk_url: Optional alternative sdk URL.
+        :type sdk_url: str
+        :param events_url: Optional alternative events URL.
+        :type events_url: str
+        :param auth_url: Optional alternative auth URL.
+        :type auth_url: str
+        :param telemetry_url: Optional alternative telemetry URL.
+        :type telemetry_url: str
+        """
+        self._timeout = timeout/1000 if timeout else None  # Convert ms to seconds.
+        self._urls = _construct_urls(sdk_url, events_url, auth_url, telemetry_url)
+        self._session = aiohttp.ClientSession()
+
+    async def get(self, server, path, apikey, query=None, extra_headers=None):  # pylint: disable=too-many-arguments
+        """
+        Issue a get request.
+        :param server: Whether the request is for SDK server, Events server or Auth server.
+        :typee server: str
+        :param path: path to append to the host url.
+        :type path: str
+        :param apikey: api token.
+        :type apikey: str
+        :param query: Query string passed as dictionary.
+        :type query: dict
+        :param extra_headers: key/value pairs of possible extra headers.
+        :type extra_headers: dict
+        :return: Tuple of status_code & response text
+        :rtype: HttpResponse
+        """
+        headers = _build_basic_headers(apikey)
+        if extra_headers is not None:
+            headers.update(extra_headers)
+        start = get_current_epoch_time_ms()
+        try:
+            url = _build_url(server, path, self._urls)
+            _LOGGER.debug("GET request: %s", url)
+            _LOGGER.debug("query params: %s", query)
+            _LOGGER.debug("headers: %s", headers)
+            async with self._session.get(
+                url,
+                params=query,
+                headers=headers,
+                timeout=self._timeout
+            ) as response:
+                body = await response.text()
+                _LOGGER.debug("Response:")
+                _LOGGER.debug(response)
+                _LOGGER.debug(body)
+                await self._record_telemetry(response.status, get_current_epoch_time_ms() - start)
+                return HttpResponse(response.status, body, response.headers)
+
+        except aiohttp.ClientError as exc:  # pylint: disable=broad-except
+            raise HttpClientException('aiohttp library is throwing exceptions') from exc
+
+    async def post(self, server, path, apikey, body, query=None, extra_headers=None):  # pylint: disable=too-many-arguments
+        """
+        Issue a POST request.
+        :param server: Whether the request is for SDK server or Events server.
+        :typee server: str
+        :param path: path to append to the host url.
+        :type path: str
+        :param apikey: api token.
+        :type apikey: str
+        :param body: body sent in the request.
+        :type body: str
+        :param query: Query string passed as dictionary.
+        :type query: dict
+        :param extra_headers: key/value pairs of possible extra headers.
+        :type extra_headers: dict
+        :return: Tuple of status_code & response text
+        :rtype: HttpResponse
+        """
+        headers = _build_basic_headers(apikey)
+        if extra_headers is not None:
+            headers.update(extra_headers)
+        start = get_current_epoch_time_ms()
+        try:
+            headers['Accept-Encoding'] = 'gzip'
+            _LOGGER.debug("POST request: %s", _build_url(server, path, self._urls))
+            _LOGGER.debug("query params: %s", query)
+            _LOGGER.debug("headers: %s", headers)
+            _LOGGER.debug("payload: ")
+            _LOGGER.debug(str(json.dumps(body)).encode('utf-8'))
+            async with self._session.post(
+                _build_url(server, path, self._urls),
+                params=query,
+                headers=headers,
+                json=body,
+                timeout=self._timeout
+            ) as response:
+                body = await response.text()
+                _LOGGER.debug("Response:")
+                _LOGGER.debug(response)
+                _LOGGER.debug(body)
+                await self._record_telemetry(response.status, get_current_epoch_time_ms() - start)
+                return HttpResponse(response.status, body, response.headers)
+
+        except aiohttp.ClientError as exc:  # pylint: disable=broad-except
+            raise HttpClientException('aiohttp library is throwing exceptions') from exc
+
+    async def _record_telemetry(self, status_code, elapsed):
+        """
+        Record Telemetry info
+
+        :param status_code: http request status code
+        :type status_code: int
+
+        :param elapsed: response time elapsed.
+        :type status_code: int
+        """
+        await self._telemetry_runtime_producer.record_sync_latency(self._metric_name, elapsed)
+        if 200 <= status_code < 300:
+            await self._telemetry_runtime_producer.record_successful_sync(self._metric_name, get_current_epoch_time_ms())
+            return
+
+        await self._telemetry_runtime_producer.record_sync_error(self._metric_name, status_code)
+
+    async def close_session(self):
+        if not self._session.closed:
+            await self._session.close()