feat(union-types): adds support for OneOf and AnyOf (#41)

This commit adds support for union types that are OneOf and AnyOf types. There are 4 new classes (OneOf, AnyOf, LeafType, UnionTypeContext) that are participating as generic algorithms for validating requests and responses containing union types. You can read more about union types [here](https://swagger.io/docs/specification/data-models/oneof-anyof-allof-not/). By using those classes, the Python core library now has the handling for union types. This also adds support for the serialization of nested maps and arrays.

Author: sufyankhanrao

README.md

@@ -66,23 +66,28 @@ pip install apimatic-core
 | [`EndpointLogger`](apimatic_core/logger/endpoint_logger.py)      | A class to provide logging for an HTTP request      |
 
 ## Types
-| Name                                                                         | Description                                                                  |
-|------------------------------------------------------------------------------|------------------------------------------------------------------------------|
-| [`SerializationFormats`](apimatic_core/types/array_serialization_format.py)  | An Enumeration of Array serialization formats                                |
-| [`DateTimeFormat`](apimatic_core/types/datetime_format.py )                  | An Enumeration of Date Time formats                                          |
-| [`ErrorCase`](apimatic_core/types/error_case.py )                            | A class to represent Exception types                                         |
-| [`FileWrapper`](apimatic_core/types/file_wrapper.py)                         | A wrapper to allow passing in content type for file uploads                  |
-| [`Parameter`](apimatic_core/types/parameter.py )                             | A class to represent information about a Parameter passed in an endpoint     |
-| [`XmlAttributes`](apimatic_core/types/xml_attributes.py )                    | A class to represent information about a XML Parameter passed in an endpoint |
+| Name                                                                          | Description                                                                  |
+|-------------------------------------------------------------------------------|------------------------------------------------------------------------------|
+| [`SerializationFormats`](apimatic_core/types/array_serialization_format.py)   | An Enumeration of Array serialization formats                                |
+| [`DateTimeFormat`](apimatic_core/types/datetime_format.py )                   | An Enumeration of Date Time formats                                          |
+| [`ErrorCase`](apimatic_core/types/error_case.py )                             | A class to represent Exception types                                         |
+| [`FileWrapper`](apimatic_core/types/file_wrapper.py)                          | A wrapper to allow passing in content type for file uploads                  |
+| [`Parameter`](apimatic_core/types/parameter.py )                              | A class to represent information about a Parameter passed in an endpoint     |
+| [`XmlAttributes`](apimatic_core/types/xml_attributes.py )                     | A class to represent information about a XML Parameter passed in an endpoint |
+| [`OneOf`](apimatic_core/types/union_types/one_of.py )                         | A class to represent information about OneOf union types                     |
+| [`AnyOf`](apimatic_core/types/union_types/any_of.py )                         | A class to represent information about AnyOf union types                     |
+| [`LeafType`](apimatic_core/types/union_types/leaf_type.py )                   | A class to represent the case information in an OneOf or AnyOf union type    |
 
 ## Utilities
-| Name                                                               | Description                                                                          |
-|--------------------------------------------------------------------|--------------------------------------------------------------------------------------|
-| [`ApiHelper`](apimatic_core/utilities/api_helper.py)               | A Helper Class with various functions associated with making an API Call             |
-| [`AuthHelper`](apimatic_core/utilities/auth_helper.py)             | A Helper Class with various functions associated with authentication in API Calls    |
-| [`ComparisonHelper`](apimatic_core/utilities/comparison_helper.py) | A Helper Class used for the comparison of expected and actual API response           |
-| [` FileHelper`](apimatic_core/utilities/file_helper.py)            | A Helper Class for files                                                             |
-| [`XmlHelper`](apimatic_core/utilities/xml_helper.py )              | A Helper class that holds utility methods for xml serialization and deserialization. |
+| Name                                                               | Description                                                                                              |
+|--------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------|
+| [`ApiHelper`](apimatic_core/utilities/api_helper.py)               | A Helper Class with various functions associated with making an API Call                                 |
+| [`AuthHelper`](apimatic_core/utilities/auth_helper.py)             | A Helper Class with various functions associated with authentication in API Calls                        |
+| [`ComparisonHelper`](apimatic_core/utilities/comparison_helper.py) | A Helper Class used for the comparison of expected and actual API response                               |
+| [`FileHelper`](apimatic_core/utilities/file_helper.py)             | A Helper Class for files                                                                                 |
+| [`XmlHelper`](apimatic_core/utilities/xml_helper.py )              | A Helper class that holds utility methods for xml serialization and deserialization.                     |
+| [`DateTimeHelper`](apimatic_core/utilities/datetime_helper.py )    | A Helper class that holds utility methods for validation of different datetime formats.                  |
+| [`UnionTypeHelper`](apimatic_core/utilities/union_type_helper.py ) | A Helper class that holds utility methods for deserialization and validation of OneOf/AnyOf union types. |
 
 ## Links
 * [apimatic-core-interfaces](https://pypi.org/project/apimatic-core-interfaces/)

apimatic_core/__init__.py

@@ -9,5 +9,6 @@
     'utilities',
     'factories',
     'types',
-    'logger'
+    'logger',
+    'exceptions'
 ]

apimatic_core/authentication/multiple/auth_group.py

@@ -38,7 +38,7 @@ def with_auth_managers(self, auth_managers):
 
         return self
 
-    def is_valid(self):
+    def is_valid(self):  # pragma: no cover
         ...
 
     def apply(self, http_request):

apimatic_core/exceptions/__init__.py

@@ -0,0 +1,4 @@
+__all__ = [
+    'oneof_validation_exception',
+    'anyof_validation_exception'
+]

apimatic_core/exceptions/anyof_validation_exception.py

@@ -0,0 +1,5 @@
+
+class AnyOfValidationException(Exception):
+    def __init__(self, message):
+        self.message = message
+        super().__init__(self.message)

apimatic_core/exceptions/oneof_validation_exception.py

@@ -0,0 +1,5 @@
+
+class OneOfValidationException(Exception):
+    def __init__(self, message):
+        self.message = message
+        super().__init__(self.message)

apimatic_core/http/configurations/http_client_configuration.py

@@ -2,7 +2,7 @@
 from apimatic_core.factories.http_response_factory import HttpResponseFactory
 
 
-class HttpClientConfiguration(object):
+class HttpClientConfiguration(object):  # pragma: no cover
     """A class used for configuring the SDK by a user.
     """
 

apimatic_core/http/http_callback.py

@@ -9,8 +9,7 @@ class HttpCallBack(object):
 
     """
 
-    def on_before_request(self,
-                          request):
+    def on_before_request(self, request):  # pragma: no cover
         """The controller will call this method before making the HttpRequest.
 
         Args:
@@ -19,8 +18,7 @@ def on_before_request(self,
         """
         raise NotImplementedError("This method has not been implemented.")
 
-    def on_after_response(self,
-                          http_response):
+    def on_after_response(self, http_response):  # pragma: no cover
         """The controller will call this method after making the HttpRequest.
 
         Args:

apimatic_core/http/request/http_request.py

@@ -56,7 +56,7 @@ def add_header(self, name, value):
         """
         self.headers[name] = value
 
-    def add_parameter(self, name, value):
+    def add_parameter(self, name, value):  # pragma: no cover
         """ Add a parameter to the HttpRequest.
 
         Args:

apimatic_core/request_builder.py

@@ -26,7 +26,6 @@ def __init__(
         self._additional_query_params = {}
         self._multipart_params = []
         self._body_param = None
-        self._should_wrap_body_param = None
         self._body_serializer = None
         self._auth = None
         self._array_serialization_format = SerializationFormats.INDEXED
@@ -90,10 +89,6 @@ def body_param(self, body_param):
             self._body_param = body_param.get_value()
         return self
 
-    def should_wrap_body_param(self, should_wrap_body_param):
-        self._should_wrap_body_param = should_wrap_body_param
-        return self
-
     def body_serializer(self, body_serializer):
         self._body_serializer = body_serializer
         return self
@@ -184,8 +179,6 @@ def process_body_params(self):
             self.add_additional_form_params()
             return ApiHelper.form_encode_parameters(self._form_params, self._array_serialization_format)
         elif self._body_param is not None and self._body_serializer:
-            if self._should_wrap_body_param:
-                return self._body_serializer(self.resolve_body_param(), self._should_wrap_body_param)
             return self._body_serializer(self.resolve_body_param())
         elif self._body_param is not None and not self._body_serializer:
             return self.resolve_body_param()