aboutsummaryrefslogtreecommitdiffstats
path: root/onap-client/onap_client/resource.py
blob: abe7bf096d180c294e8cb81ae7a4f8e2590495a5 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
# -*- coding: utf8 -*-
# ============LICENSE_START=======================================================
# org.onap.vvp/validation-scripts
# ===================================================================
# Copyright © 2020 AT&T Intellectual Property. All rights reserved.
# ===================================================================
#
# Unless otherwise specified, all software contained herein is licensed
# under the Apache License, Version 2.0 (the "License");
# you may not use this software except in compliance with the License.
# You may obtain a copy of the License at
#
#             http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
#
#
#
# Unless otherwise specified, all documentation contained herein is licensed
# under the Creative Commons License, Attribution 4.0 Intl. (the "License");
# you may not use this documentation except in compliance with the License.
# You may obtain a copy of the License at
#
#             https://creativecommons.org/licenses/by/4.0/
#
# Unless required by applicable law or agreed to in writing, documentation
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
#
# ============LICENSE_END============================================
from abc import ABC
from onap_client.exceptions import (
    InvalidSpecException,
    ResourceAlreadyExistsException,
    ResourceCreationFailure,
    ResourceDeleteFailure
)
from onap_client.client.clients import get_client as Client


class Resource(ABC):
    resource_name = "abstract"
    spec = {}

    def __init__(self, oc=None, **kwargs):
        self.attributes = {}

        if not oc:
            self.oc = Client()
        else:
            self.oc = oc

        self.input_spec = self.validate(kwargs, spec=self.spec)

    def __getattr__(self, attr):
        return self.attributes.get(attr, None)

    def create(self):
        attributes = self._create(self.input_spec)
        self.resolve_attributes(attributes)
        self._post_create()

    def delete(self):
        self._delete(self.input_spec)

    def _create(self, input):
        pass

    def _delete(self, input):
        pass

    def _post_create(self):
        pass

    def _submit(self):
        pass

    def _on_failure(self):
        pass

    def _output(self):
        return None

    @classmethod
    def create_from_spec(cls, spec, submit=True, oc=None):
        instance = cls(**spec, oc=oc)

        try:
            instance.create()
            if submit:
                instance._submit()
        except ResourceAlreadyExistsException:
            raise
        except Exception as e:
            instance._on_failure()
            raise ResourceCreationFailure(
                "Failed to create resource {}: {}".format(instance.resource_name, str(e))
            )

        return instance

    @classmethod
    def delete_from_spec(cls, spec, oc=None):
        instance = cls(**spec, oc=oc)

        try:
            instance.delete()
        except Exception as e:
            raise ResourceDeleteFailure(
                "Failed to delete resource {}: {}".format(instance.resource_name, str(e))
            )

        return instance

    def resolve_attributes(self, attributes):
        for key, val in attributes.items():
            self.attributes[key] = val

    @classmethod
    def validate(cls, input, spec=None):
        """Validates that an input dictionary spec
        is valid according to a provided class spec.

        Recursively walksdown and checks if all required attributes are present, and
        attribute types match spec types.

        Returns complete spec with all attributes.
        """
        valid_spec = {}
        if not spec:
            spec = cls.spec

        validate_spec_type(input)
        validate_spec_properties(input, spec)

        for property_name, v in spec.items():
            property_value = cls.validate_spec_item(property_name, v, input, spec)
            valid_spec[property_name] = property_value

        return valid_spec

    @classmethod
    def validate_spec_item(cls, property_name, property_item, input, spec):
        property_type = property_item.get("type")
        property_required = property_item.get("required")
        property_default = property_item.get("default", default_empty_value(property_type))

        input_property = validate_property(
            input, property_name, property_required, property_default, property_type
        )

        if (
            property_type == dict
            and input_property != property_default
            and property_item.get("nested")
        ):
            property_value = cls.validate(input_property, property_item.get("nested"))
        elif property_type == list:
            list_property_type = property_item.get("list_item")
            list_spec = []
            for item in input_property:
                if type(item) != list_property_type:
                    raise InvalidSpecException(
                        "list item {} not match type {}".format(
                            item, list_property_type
                        )
                    )
                if list_property_type == str:
                    list_spec.insert(0, item)
                else:
                    list_spec.insert(0, cls.validate(item, property_item.get("nested", {})))

            property_value = list_spec
        else:
            property_value = input_property

        return property_value


def validate_spec_type(input_spec):
    if not isinstance(input_spec, dict):
        raise InvalidSpecException("input spec was not a dictionary")


def validate_spec_properties(input_spec, spec):
    for k, v in input_spec.items():
        if not spec.get(k):
            raise InvalidSpecException("Unknown property found: {}".format(k))


def validate_property(
    input_spec, property_name, property_required, property_default, property_type
):
    input_property = input_spec.get(property_name)
    if not input_property:
        if property_required:
            raise InvalidSpecException(
                "required property {} not found in input spec".format(property_name)
            )
        else:
            input_property = property_default
    elif type(input_property) != property_type:
        raise InvalidSpecException(
            "input property {} not match type {}".format(property_name, property_type)
        )

    return input_property


def default_empty_value(property_type):
    if property_type == str:
        return None
    elif property_type == list:
        return []
    elif property_type == dict:
        return {}
    elif property_type == bool:
        return False
    else:
        return None