test_api_swagger.py

import unittest
from unittest import mock 
from lib import utils
from lib.api_endpoint.swagger2.api_swagger_parameter_handler import ApiSwaggerParaHandler
from lib.api_endpoint.swagger2.api_swagger_response_handler import ApiSwaggerRespHandler
from lib.api_endpoint.swagger2.api_metamodel2swagger import ApiMetamodel2Swagger
from lib.swagger_final_path_processing import SwaggerPathProcessing


class TestApiSwaggerParaHandler(unittest.TestCase):

    user_defined_type_mock = mock.Mock()
    user_defined_type_mock.resource_type = 'com.vmware.vapi.structure'
    user_defined_type_mock.resource_id = 'com.vmware.package.mock'
    field_info_mock = mock.Mock()
    field_info_type = mock.Mock()
    field_info_type.category = 'USER_DEFINED'
    field_info_type.user_defined_type = user_defined_type_mock
    field_info_mock.type = field_info_type
    field_info_mock.documentation = 'fieldInfoMockDescription'
    field_info_mock.name = 'fieldInfoMockName'
    field_info_mock.metadata = {}
    structure_info_mock = mock.Mock()
    structure_info_mock.fields = [field_info_mock]
    structure_dict = {
        'com.vmware.package.mock': structure_info_mock
    }
    enum_dict = {}
    api_swagger_parahandler = ApiSwaggerParaHandler()

    def test_convert_field_info_to_swagger_parameter(self):
        # generic construction of parameter object (dictionary) using field info of path and query parameters
        type_dict = {
            'com.vmware.package.mock' : { 
                'description' : 'typeObjectMockDescription',
                'type': 'MockType'
            },
            'ComVmwarePackageMock': {
                'description': 'typeObjectMockDescription',
                'type': 'MockType'
            }
        }
        
        parameter_obj_actual = self.api_swagger_parahandler.convert_field_info_to_swagger_parameter('path', self.field_info_mock, 
                                                                          type_dict, self.structure_dict, 
                                                                          self.enum_dict, False)                   
        parameter_obj_expected = {
            'required': True,
            'in': 'path',
            'name': 'fieldInfoMockName',
            'description': '{ 1. typeObjectMockDescription }, { 2. fieldInfoMockDescription }',
            'type': 'MockType'
        }                        
        self.assertEqual(parameter_obj_expected, parameter_obj_actual)

    def test_wrap_body_params(self):
        # validate parameter object by creating json wrappers around body object 
        type_dict = {
            'com.vmware.package.mock': {},
            'ComVmwarePackageMock': {}
        }
        body_param_list = [self.field_info_mock]
        parameter_obj_actual = self.api_swagger_parahandler.wrap_body_params('com.vmware.package.mock', 'mockOperationName', 
                                                                           body_param_list, type_dict, self.structure_dict, 
                                                                           self.enum_dict, False)         
        parameter_obj_expected = {
            'in': 'body',
            'name': 'request_body',
            'schema': {'$ref': '#/definitions/ComVmwarePackageMockMockOperationName'}
        }
        self.assertEqual(parameter_obj_expected, parameter_obj_actual)

        # validate parameter object by creating json wrappers around body object
        element_value_mock = mock.Mock()
        element_value_mock.string_value = 'elementMockName'
        metadata_mock = mock.Mock()
        metadata_mock.elements = {"name": element_value_mock}

        self.field_info_mock.metadata = {"BodyField": metadata_mock}
        parameter_obj_actual = self.api_swagger_parahandler.wrap_body_params('com.vmware.package.mock', 'mockOperationName',
                                                                           body_param_list, type_dict, self.structure_dict,
                                                                           self.enum_dict, False)
        parameter_obj_expected = {
            'in': 'body',
            'name': 'request_body',
            'required': True,
            'schema': {'$ref': '#/definitions/ComVmwarePackageMockMockOperationName'}
        }
        self.assertEqual(parameter_obj_expected, parameter_obj_actual)
    
    def test_flatten_query_param_spec(self):
        # case 1: parameter object takes reference from type_dict key
        # case 1.1: type dict reference value contains properties
        # case 1.1.1: property value inside type_dict is defined in-place
        query_info_mock = mock.Mock()
        query_info_type = mock.Mock()
        query_info_type.category = 'USER_DEFINED'
        query_info_type.user_defined_type = self.user_defined_type_mock
        query_info_mock.type = query_info_type
        query_info_mock.documentation = 'QueryMockDescription'
        query_info_mock.name = 'QueryParameterMockName'
        type_dict = {
            'com.vmware.package.mock' : {  #type_ref
                'properties': { 
                    'property-name': {   #property_value
                        'type': 'array',
                        'items': {
                            '$ref': '#/definitions/com.vmware.package.mock.items'
                        },
                        'description' : 'mock property description'
                    }
                }
            },
            'com.vmware.package.mock.items': {
                'type': 'string',
                'description': 'some mock description'
            },
            'ComVmwarePackageMock': {  # type_ref
                'properties': {
                    'property-name': {  # property_value
                        'type': 'array',
                        'items': {
                            '$ref': '#/definitions/com.vmware.package.mock.items'
                        },
                        'description': 'mock property description'
                    }
                }
            },
            'ComVmwarePackageMockItems': {
                'type': 'string',
                'description': 'some mock description'
            }
        }
        structure_dict = {}
        par_array_actual = self.api_swagger_parahandler.flatten_query_param_spec(query_info_mock, type_dict, 
                                                        structure_dict, self.enum_dict, False)
        par_array_expected = [
            {
                'in':'query',
                'name': 'property-name',
                'type': 'array',
                'collectionFormat': 'multi',
                'items': {'type': 'string'}, 
                'description': 'mock property description'
            }
        ]
        self.assertEqual(par_array_expected, par_array_actual)

        # type reference dictionary is empty
        type_dict = {
            'com.vmware.package.mock' : None,
            'ComVmwarePackageMock': None
        }
        par_array_actual = self.api_swagger_parahandler.flatten_query_param_spec(query_info_mock, type_dict, 
                                                                        structure_dict, self.enum_dict, False)
        par_array_expected = None
        self.assertEqual(par_array_expected, par_array_actual)

        # case 1.1.2: property value is referenced from type_dict
        type_dict = {
            'com.vmware.package.mock' : {  #type_ref
                'properties': { 
                    'property-name': {   #property_value
                        '$ref': '#/definitions/com.vmware.package.mock.property'
                    },
                    'property-name-mock': {}
                },
                'required': ['property-name-mock']
            },
            'com.vmware.package.mock.property': { #prop_obj
                'type': 'object',
                'enum': ['enum-value-1, enum-value-2'],
                'description': 'mock property description'

            },
            'ComVmwarePackageMock': {  # type_ref
                'properties': {
                    'property-name': {  # property_value
                        '$ref': '#/definitions/com.vmware.package.mock.property'
                    },
                    'property-name-mock': {}
                },
                'required': ['property-name-mock']
            },
            'ComVmwarePackageMockProperty': {  # prop_obj
                'type': 'object',
                'enum': ['enum-value-1, enum-value-2'],
                'description': 'mock property description'

            }
        }
        par_array_actual = self.api_swagger_parahandler.flatten_query_param_spec(query_info_mock, type_dict, 
                                                        structure_dict, self.enum_dict, False)
        par_array_expected = [
            {
                'in':'query',
                'name': 'property-name',
                'type': 'string',
                'enum': ['enum-value-1, enum-value-2'], 
                'description': 'mock property description',
                'required': False
            },
            {
                'in': 'query',
                'name': 'property-name-mock',
                'required': True
            }
        ]
        self.assertEqual(par_array_expected, par_array_actual)
    
        # case 1.2: type dict reference value does not contain properties
        type_dict = {
            'com.vmware.package.mock' : {  #type_ref
                'description' : 'mock description',
                'type': 'string',
                'enum': ['enum-1', 'enum-2']
            },
            'ComVmwarePackageMock': {  # type_ref
                'description': 'mock description',
                'type': 'string',
                'enum': ['enum-1', 'enum-2']
            }
        }
        par_array_actual = self.api_swagger_parahandler.flatten_query_param_spec(query_info_mock, type_dict, 
                                                        structure_dict, self.enum_dict, False)
        par_array_expected = [
            {
                'in':'query',
                'name': 'QueryParameterMockName',
                'description': 'mock description',
                'type': 'string',
                'enum': ['enum-1', 'enum-2'], 
                'required': True
            }
        ]
        self.assertEqual(par_array_expected, par_array_actual)

        # case 2: parameter object does not take reference from type dict key
        query_info_mock = mock.Mock()
        query_info_type = mock.Mock()
        query_info_type.category = 'BUILTIN'
        query_info_type.builtin_type = 'string'
        query_info_mock.type = query_info_type
        query_info_mock.documentation = 'QueryMockDescription'
        query_info_mock.name = 'QueryParameterMockName'
        type_dict = {}
        par_array_actual = self.api_swagger_parahandler.flatten_query_param_spec(query_info_mock, type_dict, 
                                                        structure_dict, self.enum_dict, False)
        par_array_expected = [
            {
                'type': 'string',
                'in':'query',
                'name': 'QueryParameterMockName',
                'description': 'QueryMockDescription',
                'required': True
            }
        ]
        self.assertEqual(par_array_expected, par_array_actual)

class TestApiSwaggerRespHandler(unittest.TestCase):

    def test_populate_response_map(self):
        # get response map corresponding to errors in operation information
        user_defined_type_mock = mock.Mock()
        user_defined_type_mock.resource_type = 'com.vmware.vapi.structure'
        user_defined_type_mock.resource_id = 'com.vmware.package.mock'
        output_mock =  mock.Mock()
        output_mock_type = mock.Mock()
        output_mock_type.category = 'USER_DEFINED'
        output_mock_type.user_defined_type = user_defined_type_mock
        output_mock.documentation = 'mock output description'
        output_mock.type = output_mock_type
        error_mock =  mock.Mock()
        error_mock.structure_id = 'com.vmware.vapi.std.errors.not_found'
        error_mock.documentation = 'mock error description'
        errors = [error_mock]
        type_dict = {
                'com.vmware.vapi.std.errors.not_found' : {},
                'com.vmware.package.mock' : { 
                    'description' : 'mock description',
                    'type': 'string',
                    'enum': ['enum-1', 'enum-2']
                }
            }
        '''
        Mock parameters : output and errors
        output( documentation = 'mock output description', 
        type = Type( category = 'USER_DEFINED', 
        user_defined_type = UserDefinedType( resource_id = 'com.vmware.package.mock', 
        resource_type = 'com.vmware.vapi.structure')))

        errors = [error( documentation = 'mock error description', structure_id = 'com.vmware.vapi.std.errors.not_found')]
        '''
        structure_info_mock = mock.Mock()
        metadata_mock = mock.Mock()
        element_value_mock = mock.Mock()
        element_value_mock.string_value = '404'
        metadata_mock.elements = { 'code' : element_value_mock}
        structure_info_mock.metadata = { 'Response' : metadata_mock}
        structures = { 'com.vmware.mock.structure' : structure_info_mock  }
        structures_obj = mock.Mock()
        structures_obj.structures = structures
        info_mock = mock.Mock()
        info_mock.packages = { 'com.vmware.vapi.std.errors' : structures_obj}
        component_svc_obj = mock.Mock()
        component_svc_obj.info = info_mock
        component_svc_mock = { 'com.vmware.vapi' : component_svc_obj}
        '''
        Mock parameter : component_svc
        component_svc = { 'com.vmware.vapi' : Component( info = ComponentInfo(
            packages = {'com.vmware.vapi.std.errors' : StructureInfo (structures = {
                'com.vmware.mock.structure' : StructureInfo(metadata = {
                    'Response' : { ElementMap( elements = ElementValue( string_value = '404'))}
                })
            })}
        ))}
        '''
        op_metadata = {'Response': metadata_mock}
        http_error_map = utils.HttpErrorMap(component_svc_mock)
        api_swagger_resphandler = ApiSwaggerRespHandler()
        response_map_actual = api_swagger_resphandler.populate_response_map(output_mock, errors, 
                                    http_error_map,type_dict, {}, {}, 'mock-service-id',
                                   'mock-operation-id', op_metadata, False)
        
        response_map_expected = {
            404: {
                'description': 'mock output description',
                'schema': {'$ref': '#/definitions/ComVmwarePackageMock'}
            },
            500: {
                'description': 'mock error description',
                'schema': {'$ref': '#/definitions/ComVmwareVapiStdErrorsNotFound'}
            }
        }
        self.assertEqual(response_map_expected, response_map_actual)
    

class TestApiSwaggerFinalPath(unittest.TestCase):
    
    api_swagger_path = SwaggerPathProcessing()

    def test_remove_query_params(self):
        # case 1: Absolute Duplicate paths, which will remain unchanged
        path_dict = {
            'mock/path1?action=mock_action':{
                'post':{
                    'parameters' : [] # parameters attr is always created even if there isn't any
                }
            },
            'mock/path1':{
                'post':{
                }
            }
        }
        path_dict_expected = {
            'mock/path1?action=mock_action':{
                'post':{
                    'parameters' : []
                }
            },
            'mock/path1':{
                'post':{
                }
            }
        }
        self.api_swagger_path.remove_query_params(path_dict)
        self.assertEqual(path_dict, path_dict_expected)

        # case 2: Partial Duplicate, adding the Operations of the new duplicate path 
        # to that of the existing path based on method type
        # case 2.1: only one of them as query parameter
        path_dict = {
            'mock/path1?action=mock_action':{
                'post':{
                    'parameters' : []
                }
            },
            'mock/path1':{
                'get':{
                    'parameters' : []
                }
            }
        }
        path_dict_expected = {
            'mock/path1': {
                'post': {
                    'parameters': [
                        {
                            'name': 'action', 
                            'in': 'query', 
                            'description':'action=mock_action', 
                            'required': True, 
                            'type': 'string', 
                            'enum': ['mock_action']
                        }
                    ]
                }, 
                'get': {
                    'parameters' : []
                }
            }
        }
        self.api_swagger_path.remove_query_params(path_dict)
        self.assertEqual(path_dict, path_dict_expected)

        # case 2.2: only one of them as query parameter without specified enum value
        path_dict = {
            'mock/path1?action':{
                'post':{
                    'parameters' : []
                }
            },
            'mock/path1':{
                'get':{
                    'parameters' : []
                }
            }
        }
        path_dict_expected = {
            'mock/path1': {
                'post': {
                    'parameters': [
                        {
                            'name': 'action',
                            'in': 'query',
                            'description':'action',
                            'required': True,
                            'type': 'string'
                        }
                    ]
                },
                'get': {
                    'parameters' : []
                }
            }
        }
        self.api_swagger_path.remove_query_params(path_dict)
        self.assertEqual(path_dict, path_dict_expected)
    
        # case 2.3: both of them have query parameter
        path_dict = {
            'mock/path1?action=mock_action_1':{
                'post':{
                    'parameters' : []
                }
            },
            'mock/path1?action=mock_action_2':{
                'get':{
                    'parameters' : []
                }
            }
        }
        path_dict_expected = {
            'mock/path1': {
                'get': {
                    'parameters': [{'name': 'action',  'in': 'query', 'description': 'action=mock_action_2', 'required': True, 'type': 'string', 'enum': ['mock_action_2']}]
                },
                'post': {
                    'parameters': [{'name': 'action',  'in': 'query', 'description': 'action=mock_action_1', 'required': True, 'type': 'string', 'enum': ['mock_action_1']}]
                }
            }
        }
        self.api_swagger_path.remove_query_params(path_dict)
        self.assertEqual(path_dict, path_dict_expected)

        # case 3: QueryParameters are fixed and method types are same
        path_dict = {
            'mock/path1?action=mock_action_1':{
                'post':{
                    'parameters' : []
                }
            },
            'mock/path1?action=mock_action_2':{
                'post':{
                    'parameters' : []
                }
            }
        }
        path_dict_expected = {
            'mock/path1?action=mock_action_2': {
                'post': {
                    'parameters': []
                }
            },
            'mock/path1': {
                'post': {
                    'parameters': [{'name': 'action', 'in': 'query', 'description': 'action=mock_action_1', 'required': True, 'type': 'string', 'enum': ['mock_action_1']}]
                }
            }
        }
        self.api_swagger_path.remove_query_params(path_dict)
        self.assertEqual(path_dict, path_dict_expected)
    

class TestApiMetamodel2Swagger(unittest.TestCase):

    api_meta2swagger = ApiMetamodel2Swagger()

    def test_post_process_path(self):
        # case 1: adding header parameter in list of parameters 
        # if path equals '/com/vmware/cis/session' and method is 'post
        # Also allow invocation of $tasks operation
        path_obj = {
            'path': '/com/vmware/cis/session',
            'method': 'post',
            'operationId': 'MockOperationId$task',
        }
        self.api_meta2swagger.post_process_path(path_obj)
        path_obj_expected = {
            'path': '/com/vmware/cis/session?vmw-task=true',
            'method': 'post',
            'operationId': 'MockOperationId$task',
            'parameters': [{
                'in': 'header',
                'required': True,
                'type': 'string',
                'name': 'vmware-use-header-authn',
                'description': 'Custom header to protect against CSRF attacks in browser based clients'
            }]
        }
        self.assertEqual(path_obj, path_obj_expected)

        # case 2: If above conditions are not satisfied, path object remains unaltered 
        path_obj = {
            'path': '/com/vmware/mock/{mock}/mock?key=value',
            'method': 'post',
            'operationId': 'MockOperationId',
        }
        path_obj_expected = path_obj
        self.api_meta2swagger.post_process_path(path_obj)
        self.assertEqual(path_obj, path_obj_expected)

if __name__ == '__main__':
    unittest.main()