cosmotech-api 3.1.1__py3-none-any.whl → 3.2.0__py3-none-any.whl

cosmotech_api/configuration.py

@@ -1,23 +1,27 @@
+# coding: utf-8
+
 """
     Cosmo Tech Platform API
 
-    Cosmo Tech Platform API  # noqa: E501
+    Cosmo Tech Platform API
 
-    The version of the OpenAPI document: 3.1.1
+    The version of the OpenAPI document: 3.2.0
     Contact: platform@cosmotech.com
-    Generated by: https://openapi-generator.tech
-"""
+    Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+    Do not edit the class manually.
+"""  # noqa: E501
 
 
 import copy
 import logging
+from logging import FileHandler
 import multiprocessing
 import sys
+from typing import Optional
 import urllib3
 
-from http import client as http_client
-from cosmotech_api.exceptions import ApiValueError
-
+import http.client as httplib
 
 JSON_SCHEMA_VALIDATION_KEYWORDS = {
     'multipleOf', 'maximum', 'exclusiveMaximum',
@@ -25,46 +29,20 @@ JSON_SCHEMA_VALIDATION_KEYWORDS = {
     'minLength', 'pattern', 'maxItems', 'minItems'
 }
 
-class Configuration(object):
-    """NOTE: This class is auto generated by OpenAPI Generator
+class Configuration:
+    """This class contains various settings of the API client.
 
-    Ref: https://openapi-generator.tech
-    Do not edit the class manually.
-
-    :param host: Base url
+    :param host: Base url.
     :param api_key: Dict to store API key(s).
       Each entry in the dict specifies an API key.
       The dict key is the name of the security scheme in the OAS specification.
       The dict value is the API key secret.
-    :param api_key_prefix: Dict to store API prefix (e.g. Bearer)
+    :param api_key_prefix: Dict to store API prefix (e.g. Bearer).
       The dict key is the name of the security scheme in the OAS specification.
       The dict value is an API key prefix when generating the auth data.
-    :param username: Username for HTTP basic authentication
-    :param password: Password for HTTP basic authentication
-    :param discard_unknown_keys: Boolean value indicating whether to discard
-      unknown properties. A server may send a response that includes additional
-      properties that are not known by the client in the following scenarios:
-      1. The OpenAPI document is incomplete, i.e. it does not match the server
-         implementation.
-      2. The client was generated using an older version of the OpenAPI document
-         and the server has been upgraded since then.
-      If a schema in the OpenAPI document defines the additionalProperties attribute,
-      then all undeclared properties received by the server are injected into the
-      additional properties map. In that case, there are undeclared properties, and
-      nothing to discard.
-    :param disabled_client_side_validations (string): Comma-separated list of
-      JSON schema validation keywords to disable JSON schema structural validation
-      rules. The following keywords may be specified: multipleOf, maximum,
-      exclusiveMaximum, minimum, exclusiveMinimum, maxLength, minLength, pattern,
-      maxItems, minItems.
-      By default, the validation is performed for data generated locally by the client
-      and data received from the server, independent of any validation performed by
-      the server side. If the input data does not satisfy the JSON schema validation
-      rules specified in the OpenAPI document, an exception is raised.
-      If disabled_client_side_validations is set, structural validation is
-      disabled. This can be useful to troubleshoot data validation problem, such as
-      when the OpenAPI document validation rules do not match the actual API data
-      received by the server.
+    :param username: Username for HTTP basic authentication.
+    :param password: Password for HTTP basic authentication.
+    :param access_token: Access token.
     :param server_index: Index to servers configuration.
     :param server_variables: Mapping with string values to replace variables in
       templated server configuration. The validation of enums is performed for
@@ -73,9 +51,10 @@ class Configuration(object):
       configuration.
     :param server_operation_variables: Mapping from operation ID to a mapping with
       string values to replace variables in templated server configuration.
-      The validation of enums is performed for variables with defined enum values before.
+      The validation of enums is performed for variables with defined enum
+      values before.
     :param ssl_ca_cert: str - the path to a file of concatenated CA certificates
-      in PEM format
+      in PEM format.
 
     :Example:
     """
@@ -84,14 +63,12 @@ class Configuration(object):
 
     def __init__(self, host=None,
                  api_key=None, api_key_prefix=None,
-                 access_token=None,
                  username=None, password=None,
-                 discard_unknown_keys=False,
-                 disabled_client_side_validations="",
+                 access_token=None,
                  server_index=None, server_variables=None,
                  server_operation_index=None, server_operation_variables=None,
                  ssl_ca_cert=None,
-                 ):
+                 ) -> None:
         """Constructor
         """
         self._base_path = "https://dev.api.cosmotech.com" if host is None else host
@@ -109,7 +86,6 @@ class Configuration(object):
         """Temp file folder for downloading files
         """
         # Authentication Settings
-        self.access_token = access_token
         self.api_key = {}
         if api_key:
             self.api_key = api_key
@@ -129,8 +105,9 @@ class Configuration(object):
         self.password = password
         """Password for HTTP basic authentication
         """
-        self.discard_unknown_keys = discard_unknown_keys
-        self.disabled_client_side_validations = disabled_client_side_validations
+        self.access_token = access_token
+        """Access token
+        """
         self.logger = {}
         """Logging Settings
         """
@@ -142,7 +119,7 @@ class Configuration(object):
         self.logger_stream_handler = None
         """Log stream handler
         """
-        self.logger_file_handler = None
+        self.logger_file_handler: Optional[FileHandler] = None
         """Log file handler
         """
         self.logger_file = None
@@ -169,6 +146,10 @@ class Configuration(object):
         self.assert_hostname = None
         """Set this to True/False to enable/disable SSL hostname verification.
         """
+        self.tls_server_name = None
+        """SSL/TLS Server Name Indication (SNI)
+           Set this to the SNI value expected by the server.
+        """
 
         self.connection_pool_maxsize = multiprocessing.cpu_count() * 5
         """urllib3 connection pool's maximum number of connections saved
@@ -178,12 +159,9 @@ class Configuration(object):
            cpu_count * 5 is used as default value to increase performance.
         """
 
-        self.proxy = None
+        self.proxy: Optional[str] = None
         """Proxy URL
         """
-        self.no_proxy = None
-        """bypass proxy for host in the no_proxy list.
-        """
         self.proxy_headers = None
         """Proxy headers
         """
@@ -196,8 +174,17 @@ class Configuration(object):
         # Enable client side validation
         self.client_side_validation = True
 
-        # Options to pass down to the underlying urllib3 socket
         self.socket_options = None
+        """Options to pass down to the underlying urllib3 socket
+        """
+
+        self.datetime_format = "%Y-%m-%dT%H:%M:%S.%f%z"
+        """datetime format
+        """
+
+        self.date_format = "%Y-%m-%d"
+        """date format
+        """
 
     def __deepcopy__(self, memo):
         cls = self.__class__
@@ -215,13 +202,6 @@ class Configuration(object):
 
     def __setattr__(self, name, value):
         object.__setattr__(self, name, value)
-        if name == 'disabled_client_side_validations':
-            s = set(filter(None, value.split(',')))
-            for v in s:
-                if v not in JSON_SCHEMA_VALIDATION_KEYWORDS:
-                    raise ApiValueError(
-                        "Invalid keyword: '{0}''".format(v))
-            self._disabled_client_side_validations = s
 
     @classmethod
     def set_default(cls, default):
@@ -232,21 +212,31 @@ class Configuration(object):
 
         :param default: object of Configuration
         """
-        cls._default = copy.deepcopy(default)
+        cls._default = default
 
     @classmethod
     def get_default_copy(cls):
-        """Return new instance of configuration.
+        """Deprecated. Please use `get_default` instead.
+
+        Deprecated. Please use `get_default` instead.
+
+        :return: The configuration object.
+        """
+        return cls.get_default()
+
+    @classmethod
+    def get_default(cls):
+        """Return the default configuration.
 
         This method returns newly created, based on default constructor,
         object of Configuration class or returns a copy of default
-        configuration passed by the set_default method.
+        configuration.
 
         :return: The configuration object.
         """
-        if cls._default is not None:
-            return copy.deepcopy(cls._default)
-        return Configuration()
+        if cls._default is None:
+            cls._default = Configuration()
+        return cls._default
 
     @property
     def logger_file(self):
@@ -300,15 +290,15 @@ class Configuration(object):
             # if debug status is True, turn on debug logging
             for _, logger in self.logger.items():
                 logger.setLevel(logging.DEBUG)
-            # turn on http_client debug
-            http_client.HTTPConnection.debuglevel = 1
+            # turn on httplib debug
+            httplib.HTTPConnection.debuglevel = 1
         else:
             # if debug status is False, turn off debug logging,
             # setting log level to default `logging.WARNING`
             for _, logger in self.logger.items():
                 logger.setLevel(logging.WARNING)
-            # turn off http_client debug
-            http_client.HTTPConnection.debuglevel = 0
+            # turn off httplib debug
+            httplib.HTTPConnection.debuglevel = 0
 
     @property
     def logger_format(self):
@@ -388,7 +378,7 @@ class Configuration(object):
         return "Python SDK Debug Report:\n"\
                "OS: {env}\n"\
                "Python Version: {pyversion}\n"\
-               "Version of the API: 3.1.1\n"\
+               "Version of the API: 3.2.0\n"\
                "SDK Package Version: 1.0.0".\
                format(env=sys.platform, pyversion=sys.version)
 

cosmotech_api/exceptions.py

@@ -1,14 +1,19 @@
+# coding: utf-8
+
 """
     Cosmo Tech Platform API
 
-    Cosmo Tech Platform API  # noqa: E501
+    Cosmo Tech Platform API
 
-    The version of the OpenAPI document: 3.1.1
+    The version of the OpenAPI document: 3.2.0
     Contact: platform@cosmotech.com
-    Generated by: https://openapi-generator.tech
-"""
+    Generated by OpenAPI Generator (https://openapi-generator.tech)
 
+    Do not edit the class manually.
+"""  # noqa: E501
 
+from typing import Any, Optional
+from typing_extensions import Self
 
 class OpenApiException(Exception):
     """The base exception class for all OpenAPIExceptions"""
@@ -16,7 +21,7 @@ class OpenApiException(Exception):
 
 class ApiTypeError(OpenApiException, TypeError):
     def __init__(self, msg, path_to_item=None, valid_classes=None,
-                 key_type=None):
+                 key_type=None) -> None:
         """ Raises an exception for TypeErrors
 
         Args:
@@ -44,7 +49,7 @@ class ApiTypeError(OpenApiException, TypeError):
 
 
 class ApiValueError(OpenApiException, ValueError):
-    def __init__(self, msg, path_to_item=None):
+    def __init__(self, msg, path_to_item=None) -> None:
         """
         Args:
             msg (str): the exception message
@@ -62,7 +67,7 @@ class ApiValueError(OpenApiException, ValueError):
 
 
 class ApiAttributeError(OpenApiException, AttributeError):
-    def __init__(self, msg, path_to_item=None):
+    def __init__(self, msg, path_to_item=None) -> None:
         """
         Raised when an attribute reference or assignment fails.
 
@@ -81,7 +86,7 @@ class ApiAttributeError(OpenApiException, AttributeError):
 
 
 class ApiKeyError(OpenApiException, KeyError):
-    def __init__(self, msg, path_to_item=None):
+    def __init__(self, msg, path_to_item=None) -> None:
         """
         Args:
             msg (str): the exception message
@@ -99,17 +104,56 @@ class ApiKeyError(OpenApiException, KeyError):
 
 class ApiException(OpenApiException):
 
-    def __init__(self, status=None, reason=None, http_resp=None):
+    def __init__(
+        self, 
+        status=None, 
+        reason=None, 
+        http_resp=None,
+        *,
+        body: Optional[str] = None,
+        data: Optional[Any] = None,
+    ) -> None:
+        self.status = status
+        self.reason = reason
+        self.body = body
+        self.data = data
+        self.headers = None
+
         if http_resp:
-            self.status = http_resp.status
-            self.reason = http_resp.reason
-            self.body = http_resp.data
+            if self.status is None:
+                self.status = http_resp.status
+            if self.reason is None:
+                self.reason = http_resp.reason
+            if self.body is None:
+                try:
+                    self.body = http_resp.data.decode('utf-8')
+                except Exception:
+                    pass
             self.headers = http_resp.getheaders()
-        else:
-            self.status = status
-            self.reason = reason
-            self.body = None
-            self.headers = None
+
+    @classmethod
+    def from_response(
+        cls, 
+        *, 
+        http_resp, 
+        body: Optional[str], 
+        data: Optional[Any],
+    ) -> Self:
+        if http_resp.status == 400:
+            raise BadRequestException(http_resp=http_resp, body=body, data=data)
+
+        if http_resp.status == 401:
+            raise UnauthorizedException(http_resp=http_resp, body=body, data=data)
+
+        if http_resp.status == 403:
+            raise ForbiddenException(http_resp=http_resp, body=body, data=data)
+
+        if http_resp.status == 404:
+            raise NotFoundException(http_resp=http_resp, body=body, data=data)
+
+        if 500 <= http_resp.status <= 599:
+            raise ServiceException(http_resp=http_resp, body=body, data=data)
+        raise ApiException(http_resp=http_resp, body=body, data=data)
 
     def __str__(self):
         """Custom error messages for exception"""
@@ -119,34 +163,30 @@ class ApiException(OpenApiException):
             error_message += "HTTP response headers: {0}\n".format(
                 self.headers)
 
-        if self.body:
-            error_message += "HTTP response body: {0}\n".format(self.body)
+        if self.data or self.body:
+            error_message += "HTTP response body: {0}\n".format(self.data or self.body)
 
         return error_message
 
 
-class NotFoundException(ApiException):
+class BadRequestException(ApiException):
+    pass
+
 
-    def __init__(self, status=None, reason=None, http_resp=None):
-        super(NotFoundException, self).__init__(status, reason, http_resp)
+class NotFoundException(ApiException):
+    pass
 
 
 class UnauthorizedException(ApiException):
-
-    def __init__(self, status=None, reason=None, http_resp=None):
-        super(UnauthorizedException, self).__init__(status, reason, http_resp)
+    pass
 
 
 class ForbiddenException(ApiException):
-
-    def __init__(self, status=None, reason=None, http_resp=None):
-        super(ForbiddenException, self).__init__(status, reason, http_resp)
+    pass
 
 
 class ServiceException(ApiException):
-
-    def __init__(self, status=None, reason=None, http_resp=None):
-        super(ServiceException, self).__init__(status, reason, http_resp)
+    pass
 
 
 def render_path(path_to_item):

cosmotech_api/model/component_role_permissions.py

@@ -3,7 +3,7 @@
 
     Cosmo Tech Platform API  # noqa: E501
 
-    The version of the OpenAPI document: 3.1.1
+    The version of the OpenAPI document: 3.1.5
     Contact: platform@cosmotech.com
     Generated by: https://openapi-generator.tech
 """

cosmotech_api/model/connector.py

@@ -3,7 +3,7 @@
 
     Cosmo Tech Platform API  # noqa: E501
 
-    The version of the OpenAPI document: 3.1.1
+    The version of the OpenAPI document: 3.1.5
     Contact: platform@cosmotech.com
     Generated by: https://openapi-generator.tech
 """

cosmotech_api/model/connector_parameter.py

@@ -3,7 +3,7 @@
 
     Cosmo Tech Platform API  # noqa: E501
 
-    The version of the OpenAPI document: 3.1.1
+    The version of the OpenAPI document: 3.1.5
     Contact: platform@cosmotech.com
     Generated by: https://openapi-generator.tech
 """

cosmotech_api/model/connector_parameter_group.py

@@ -3,7 +3,7 @@
 
     Cosmo Tech Platform API  # noqa: E501
 
-    The version of the OpenAPI document: 3.1.1
+    The version of the OpenAPI document: 3.1.5
     Contact: platform@cosmotech.com
     Generated by: https://openapi-generator.tech
 """

cosmotech_api/model/container_resource_size_info.py

@@ -3,7 +3,7 @@
 
     Cosmo Tech Platform API  # noqa: E501
 
-    The version of the OpenAPI document: 3.1.1
+    The version of the OpenAPI document: 3.1.5
     Contact: platform@cosmotech.com
     Generated by: https://openapi-generator.tech
 """

cosmotech_api/model/container_resource_sizing.py

@@ -3,7 +3,7 @@
 
     Cosmo Tech Platform API  # noqa: E501
 
-    The version of the OpenAPI document: 3.1.1
+    The version of the OpenAPI document: 3.1.5
     Contact: platform@cosmotech.com
     Generated by: https://openapi-generator.tech
 """

cosmotech_api/model/dataset.py

@@ -3,7 +3,7 @@
 
     Cosmo Tech Platform API  # noqa: E501
 
-    The version of the OpenAPI document: 3.1.1
+    The version of the OpenAPI document: 3.1.5
     Contact: platform@cosmotech.com
     Generated by: https://openapi-generator.tech
 """

cosmotech_api/model/dataset_access_control.py

@@ -3,7 +3,7 @@
 
     Cosmo Tech Platform API  # noqa: E501
 
-    The version of the OpenAPI document: 3.1.1
+    The version of the OpenAPI document: 3.1.5
     Contact: platform@cosmotech.com
     Generated by: https://openapi-generator.tech
 """

cosmotech_api/model/dataset_compatibility.py

@@ -3,7 +3,7 @@
 
     Cosmo Tech Platform API  # noqa: E501
 
-    The version of the OpenAPI document: 3.1.1
+    The version of the OpenAPI document: 3.1.5
     Contact: platform@cosmotech.com
     Generated by: https://openapi-generator.tech
 """

cosmotech_api/model/dataset_connector.py

@@ -3,7 +3,7 @@
 
     Cosmo Tech Platform API  # noqa: E501
 
-    The version of the OpenAPI document: 3.1.1
+    The version of the OpenAPI document: 3.1.5
     Contact: platform@cosmotech.com
     Generated by: https://openapi-generator.tech
 """

cosmotech_api/model/dataset_copy_parameters.py

@@ -3,7 +3,7 @@
 
     Cosmo Tech Platform API  # noqa: E501
 
-    The version of the OpenAPI document: 3.1.1
+    The version of the OpenAPI document: 3.1.5
     Contact: platform@cosmotech.com
     Generated by: https://openapi-generator.tech
 """

cosmotech_api/model/dataset_role.py

@@ -3,7 +3,7 @@
 
     Cosmo Tech Platform API  # noqa: E501
 
-    The version of the OpenAPI document: 3.1.1
+    The version of the OpenAPI document: 3.1.5
     Contact: platform@cosmotech.com
     Generated by: https://openapi-generator.tech
 """

cosmotech_api/model/dataset_search.py

@@ -3,7 +3,7 @@
 
     Cosmo Tech Platform API  # noqa: E501
 
-    The version of the OpenAPI document: 3.1.1
+    The version of the OpenAPI document: 3.1.5
     Contact: platform@cosmotech.com
     Generated by: https://openapi-generator.tech
 """

cosmotech_api/model/dataset_security.py

@@ -3,7 +3,7 @@
 
     Cosmo Tech Platform API  # noqa: E501
 
-    The version of the OpenAPI document: 3.1.1
+    The version of the OpenAPI document: 3.1.5
     Contact: platform@cosmotech.com
     Generated by: https://openapi-generator.tech
 """

cosmotech_api/model/dataset_source_type.py

@@ -3,7 +3,7 @@
 
     Cosmo Tech Platform API  # noqa: E501
 
-    The version of the OpenAPI document: 3.1.1
+    The version of the OpenAPI document: 3.1.5
     Contact: platform@cosmotech.com
     Generated by: https://openapi-generator.tech
 """

cosmotech_api/model/dataset_twin_graph_hash.py

@@ -3,7 +3,7 @@
 
     Cosmo Tech Platform API  # noqa: E501
 
-    The version of the OpenAPI document: 3.1.1
+    The version of the OpenAPI document: 3.1.5
     Contact: platform@cosmotech.com
     Generated by: https://openapi-generator.tech
 """

cosmotech_api/model/dataset_twin_graph_info.py

@@ -3,7 +3,7 @@
 
     Cosmo Tech Platform API  # noqa: E501
 
-    The version of the OpenAPI document: 3.1.1
+    The version of the OpenAPI document: 3.1.5
     Contact: platform@cosmotech.com
     Generated by: https://openapi-generator.tech
 """

cosmotech_api/model/dataset_twin_graph_query.py

@@ -3,7 +3,7 @@
 
     Cosmo Tech Platform API  # noqa: E501
 
-    The version of the OpenAPI document: 3.1.1
+    The version of the OpenAPI document: 3.1.5
     Contact: platform@cosmotech.com
     Generated by: https://openapi-generator.tech
 """

cosmotech_api/model/delete_historical_data.py

@@ -3,7 +3,7 @@
 
     Cosmo Tech Platform API  # noqa: E501
 
-    The version of the OpenAPI document: 3.1.1
+    The version of the OpenAPI document: 3.1.5
     Contact: platform@cosmotech.com
     Generated by: https://openapi-generator.tech
 """

cosmotech_api/model/file_upload_metadata.py

@@ -3,7 +3,7 @@
 
     Cosmo Tech Platform API  # noqa: E501
 
-    The version of the OpenAPI document: 3.1.1
+    The version of the OpenAPI document: 3.1.5
     Contact: platform@cosmotech.com
     Generated by: https://openapi-generator.tech
 """

cosmotech_api/model/file_upload_validation.py

@@ -3,7 +3,7 @@
 
     Cosmo Tech Platform API  # noqa: E501
 
-    The version of the OpenAPI document: 3.1.1
+    The version of the OpenAPI document: 3.1.5
     Contact: platform@cosmotech.com
     Generated by: https://openapi-generator.tech
 """

cosmotech_api/model/graph_properties.py

@@ -3,7 +3,7 @@
 
     Cosmo Tech Platform API  # noqa: E501
 
-    The version of the OpenAPI document: 3.1.1
+    The version of the OpenAPI document: 3.1.5
     Contact: platform@cosmotech.com
     Generated by: https://openapi-generator.tech
 """

cosmotech_api/model/organization.py

@@ -3,7 +3,7 @@
 
     Cosmo Tech Platform API  # noqa: E501
 
-    The version of the OpenAPI document: 3.1.1
+    The version of the OpenAPI document: 3.1.5
     Contact: platform@cosmotech.com
     Generated by: https://openapi-generator.tech
 """