Completed
Push — master ( bd4af6...14a33c )
by Olivier
04:12
created

XMLParser._split_node_id()   A

Complexity

Conditions 3

Size

Total Lines 13

Duplication

Lines 0
Ratio 0 %

Code Coverage

Tests 6
CRAP Score 3.8449

Importance

Changes 0
Metric Value
cc 3
dl 0
loc 13
ccs 6
cts 11
cp 0.5455
crap 3.8449
rs 9.4285
c 0
b 0
f 0
1
"""
2
parse xml file from opcua-spec
3
"""
4 1
import logging
5 1
import re
6 1
import sys
7
8 1
import xml.etree.ElementTree as ET
9
10
11 1
class NodeData(object):
12
13 1
    def __init__(self):
14 1
        self.nodetype = None
15 1
        self.nodeid = None
16 1
        self.browsename = None
17 1
        self.displayname = None
18 1
        self.symname = None  # FIXME: this param is never used, why?
19 1
        self.parent = None
20 1
        self.parentlink = None
21 1
        self.desc = ""
22 1
        self.typedef = None
23 1
        self.refs = []
24 1
        self.nodeclass = None
25 1
        self.eventnotifier = 0
26
27
        # variable
28 1
        self.datatype = None
29 1
        self.rank = -1  # check default value
30 1
        self.value = None
31 1
        self.valuetype = None
32 1
        self.dimensions = None
33 1
        self.accesslevel = None
34 1
        self.useraccesslevel = None
35 1
        self.minsample = None
36
37
        # referencetype
38 1
        self.inversename = ""
39 1
        self.abstract = "false"
40 1
        self.symmetric = "false"
41
42
        # datatype
43 1
        self.definition = []
44
45
46 1
class RefStruct(object):
47
48 1
    def __init__(self):
49
        self.reftype = None
50
        self.forward = True
51
        self.target = None
52
53
54 1
class XMLParser(object):
55
56 1
    def __init__(self, xmlpath, server):
57 1
        self.server = server  # POC
58 1
        self.logger = logging.getLogger(__name__)
59 1
        self._retag = re.compile(r"(\{.*\})(.*)")
60 1
        self.path = xmlpath
61
        self.aliases = {}
62 1
63 1
        self.tree = ET.parse(xmlpath)
64 1
        self.root = self.tree.getroot()
65
        self.it = None
66 1
67 1
        self.namespaces = {}
68 1
        self._re_nodeid = re.compile(r"^ns=(?P<ns>\d+[^;]*);i=(?P<i>\d+)")
69
70 1
    def __iter__(self):
71 1
        nodes = []
72 1
        for child in self.root:
73
            name = self._retag.match(child.tag).groups()[1]
74
            if name == "Aliases":
75 1
                for el in child:
76 1
                    self.aliases[el.attrib["Alias"]] = self._get_node_id(el.text)
77 1
            elif name == 'NamespaceUris':
78
                for ns_index, ns_element in enumerate(child):
79
                    ns_uri = ns_element.text
80
                    ns_server_index = self.server.register_namespace(ns_uri)
81 1
                    self.namespaces[ns_index + 1] = (ns_server_index, ns_uri)
82 1
            else:
83
                node = self._parse_node(name, child)
84 1
                nodes.append(node)
85
86
        # The ordering of nodes currently only works if namespaces are
87 1
        # defined in XML.
88 1
        # Also, it is recommended not to use node ids without namespace prefix!
89 1
        if self.namespaces:
90 1
            nodes = self._sort_nodes_by_parentid(nodes)
91 1
92 1
        self.it = iter(nodes)
93 1
        return self
94 1
95 1
    def __next__(self):
96
        while True:
97 1
            if sys.version_info[0] < 3:
98 1
                child = self.it.next()
99 1
            else:
100 1
                child = self.it.__next__()
101 1
            return child
102 1
103
    def next(self):  # support for python2
104 1
        return self.__next__()
105
106 1
    def _sort_nodes_by_parentid(self, nodes):
107 1
        """
108
        Sort the list of nodes according theire parent node in order to respect
109
        the depency between nodes.
110
111
        :param nodes: list of NodeDataObjects
112
        :returns: list of sorted nodes
113
        """
114
        _nodes = list(nodes)
115
        # list of node ids that are already sorted / inserted
116
        sorted_nodes_ids = []
117
        # list of sorted nodes (i.e. XML Elements)
118
        sorted_nodes = []
119
        # list of namespace indexes that are relevant for this import
120
        # we can only respect ordering nodes for namespaces indexes that
121
        # are defined in the xml file itself. Thus we assume that all other
122
        # references namespaces are already known to the server and should
123
        # not create any dependency problems (like "NodeNotFound")
124
        relevant_namespaces = [str(i[0]) for i in self.namespaces.values()]
125
        while len(_nodes) > 0:
126
            pop_nodes = []
127
            for node in _nodes:
128 1
                insert = None
129 1
                # Get the node and parent node namespace and id parts
130
                node_ns, node_id = self._split_node_id(node.nodeid)
131 1
                parent_ns, parent_id = self._split_node_id(node.parent)
132
133 1
                # Insert nodes that
134 1
                #   (1) have no parent / parent_ns is None (e.g. namespace 0)
135 1
                #   (2) ns is not in list of relevant namespaces
136 1
                if (parent_ns is None or node_ns not in relevant_namespaces or
137 1
                    parent_id is None):
138 1
                    insert = 0
139
                else:
140
                    # Check if the nodes parent is already in the list of
141
                    # inserted nodes
142
                    if node.parent in sorted_nodes_ids:
143
                        insert = -1
144
                if insert in [0, -1]:
145
                    sorted_nodes.insert(insert, node)
146
                    sorted_nodes_ids.insert(insert, node.nodeid)
147 1
                    pop_nodes.append(node)
148 1
149 1
            # Remove inserted nodes from the list
150 1
            for node in pop_nodes:
151 1
                _nodes.pop(_nodes.index(node))
152 1
153 1
        return sorted_nodes
154
155 1
    def _split_node_id(self, value):
156
        """
157
        Split the fq node id into namespace and id part.
158
159
        :returns: (namespace, id)
160 1
        """
161 1
        if not value:
162 1
            return (None, value)
163
        r_match = self._re_nodeid.search(value)
164 1
        if r_match:
165
            return r_match.groups()
166 1
167
        return (None, value)
168
169
    def _get_node_id(self, value):
170
        """
171
        Check if the nodeid given in the xml model file must be converted
172
        to a already existing namespace id based on the files namespace uri
173
174 1
        :returns: NodeId (str)
175 1
        """
176 1
        result = value
177 1
178 1
        node_ns, node_id = self._split_node_id(value)
179
        if node_ns:
180
            ns_server = self.namespaces.get(int(node_ns), None)
181 1
            if ns_server:
182 1
                result = "ns={};i={}".format(ns_server[0], node_id)
183
        return result
184
185
    def _parse_node(self, name, child):
186
        obj = NodeData()
187
        obj.nodetype = name
188
        for key, val in child.attrib.items():
189
            self._set_attr(key, val, obj)
190
        obj.displayname = obj.browsename  # give a default value to display name
191
        for el in child:
192
            self._parse_tag(el, obj)
193
        return obj
194
195
    def _set_attr(self, key, val, obj):
196
        if key == "NodeId":
197
            obj.nodeid = self._get_node_id(val)
198
        elif key == "BrowseName":
199
            obj.browsename = val
200
        elif key == "SymbolicName":
201
            obj.symname = val
202
        elif key == "ParentNodeId":
203
            obj.parent = self._get_node_id(val)
204
        elif key == "DataType":
205
            obj.datatype = val
206
        elif key == "IsAbstract":
207
            obj.abstract = val
208
        elif key == "EventNotifier":
209
            obj.eventnotifier = 1 if val == "1" else 0
210
        elif key == "ValueRank":
211
            obj.rank = int(val)
212
        elif key == "ArrayDimensions":
213
            obj.dimensions = [int(i) for i in val.split(",")]
214
        elif key == "MinimumSamplingInterval":
215
            obj.minsample = int(val)
216
        elif key == "AccessLevel":
217
            obj.accesslevel = int(val)
218
        elif key == "UserAccessLevel":
219
            obj.useraccesslevel = int(val)
220
        elif key == "Symmetric":
221
            obj.symmetric = True if val == "true" else False
222
        else:
223
            self.logger.info("Attribute not implemented: %s:%s", key, val)
224
225
    def _parse_tag(self, el, obj):
226
        tag = self._retag.match(el.tag).groups()[1]
227
228
        if tag == "DisplayName":
229
            obj.displayname = el.text
230
        elif tag == "Description":
231
            obj.desc = el.text
232
        elif tag == "References":
233
            self._parse_refs(el, obj)
234
        elif tag == "Value":
235
            self._parse_value(el, obj)
236
        elif tag == "InverseName":
237
            obj.inversename = el.text
238
        elif tag == "Definition":
239
            for field in el:
240
                obj.definition.append(field)
241
        else:
242
            self.logger.info("Not implemented tag: %s", el)
243
244
    def _parse_value(self, el, obj):
245
        for val in el:
246
            ntag = self._retag.match(val.tag).groups()[1]
247
            obj.valuetype = ntag
248
            if ntag in ("Int8", "UInt8", "Int16", "UInt16", "Int32", "UInt32", "Int64", "UInt64"):
249
                obj.value = int(val.text)
250
            elif ntag in ("Float", "Double"):
251
                obj.value = float(val.text)
252
            elif ntag in ("Boolean"):
253
                if val.text in ("True", "true", "1", "on", "On"):
254
                    obj.value = bool(1)
255
                else:
256
                    obj.value = bool(0)
257
            elif ntag in ("ByteString", "String"):
258
                mytext = val.text
259
                if mytext is None:  # support importing null strings
260
                    mytext = ""
261
                mytext = mytext.replace('\n', '').replace('\r', '')
262
                # obj.value.append('b"{}"'.format(mytext))
263
                obj.value = mytext
264
            elif ntag == "ListOfExtensionObject":
265
                obj.value, obj.valuetype = self._parse_list_of_extension_object(el)
266
            elif ntag == "ListOfLocalizedText":
267
                obj.value = self._parse_list_of_localized_text(el)
268
            else:
269
                self.logger.info("Value type not implemented: %s", ntag)
270
271
    def _get_text(self, el):
272
        txt = ""
273
        for text in el.itertext():
274
            txt += text
275
        return txt
276
277
    def _parse_list_of_localized_text(self, el):
278
        value = []
279
        for localized_text_list in el:
280
            for localized_text in localized_text_list:
281
                ntag = self._retag.match(localized_text.tag).groups()[1]
282
                for child in localized_text:
283
                    ntag = self._retag.match(child.tag).groups()[1]
284
                    if ntag == 'Text':
285
                        value.append(self._get_text(child))
286
        return value
287
288
    def _parse_list_of_extension_object(self, el):
289
        '''
290
        Parse a uax:ListOfExtensionObject Value
291
        
292
        Return an array with a value of each uax:ExtensionObject/*/* (each element is convert to a netry in a dict.
293
               also the valuetype is returned. The valuetype is  uax:ExtensionObject/*/tag()
294
        '''
295
        value = []
296
        valuetype = None
297
        for extension_object_list in el:
298
            for extension_object in extension_object_list:
299
                extension_object.find('Body')
300
                for extension_object_part in extension_object:
301
                    ntag = self._retag.match(extension_object_part.tag).groups()[1]
302
                    if ntag == 'Body':
303
                        data = {}
304
                        ntag = self._retag.match(extension_object_part.find('*').tag).groups()[1]
305
                        valuetype = ntag
306
                        for body_item in extension_object_part.findall('*/*'):
307
                            ntag = self._retag.match(body_item.tag).groups()[1]
308
309
                            child = body_item.find('*')
310
                            if child is not None:
311
                                data[ntag] = self._get_text(child)
312
                            else:
313
                                data[ntag] = self._get_text(body_item)
314
                        value.append(data)
315
        return value, valuetype
316
317
    def _parse_refs(self, el, obj):
318
        for ref in el:
319
            if ref.attrib["ReferenceType"] == "HasTypeDefinition":
320
                obj.typedef = self._get_node_id(ref.text)
321
            elif "IsForward" in ref.attrib and ref.attrib["IsForward"] == "false":
322
                # if obj.parent:
323
                    # sys.stderr.write("Parent is already set with: "+ obj.parent + " " + ref.text + "\n")
324
                obj.parent = self._get_node_id(ref.text)
325
                obj.parentlink = ref.attrib["ReferenceType"]
326
            else:
327
                struct = RefStruct()
328
                if "IsForward" in ref.attrib:
329
                    struct.forward = ref.attrib["IsForward"]
330
                struct.target = self._get_node_id(ref.text)
331
                struct.reftype = ref.attrib["ReferenceType"]
332
                obj.refs.append(struct)
333