28972318 |
1 | #!/usr/bin/env python |
2 | |
3 | # Copyright (c) 2007, Intel Corporation |
4 | # All rights reserved. This program and the accompanying materials |
5 | # are licensed and made available under the terms and conditions of the BSD License |
6 | # which accompanies this distribution. The full text of the license may be found at |
7 | # http://opensource.org/licenses/bsd-license.php |
8 | # |
9 | # THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, |
10 | # WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. |
11 | |
12 | """This is an XML API that uses a syntax similar to XPath, but it is written in |
13 | standard python so that no extra python packages are required to use it.""" |
14 | |
15 | import xml.dom.minidom |
16 | |
17 | def XmlList(Dom, String): |
18 | """Get a list of XML Elements using XPath style syntax.""" |
19 | if String == "" or Dom == None or not isinstance(Dom, xml.dom.Node): |
20 | return [] |
21 | |
22 | if String[0] == "/": |
23 | String = String[1:] |
24 | |
25 | if Dom.nodeType==Dom.DOCUMENT_NODE: |
26 | Dom = Dom.documentElement |
27 | |
28 | tagList = String.split('/') |
29 | nodes = [Dom] |
30 | childNodes = [] |
31 | index = 0 |
32 | end = len(tagList) - 1 |
33 | while index <= end: |
34 | for node in nodes: |
35 | if node.nodeType == node.ELEMENT_NODE and node.tagName == tagList[index]: |
36 | if index < end: |
37 | childNodes.extend(node.childNodes) |
38 | else: |
39 | childNodes.append(node) |
40 | |
41 | nodes = childNodes |
42 | childNodes = [] |
43 | index += 1 |
44 | |
45 | return nodes |
46 | |
47 | def XmlElement (Dom, String): |
48 | """Return a single element that matches the String which is XPath style syntax.""" |
49 | if String == "" or Dom == None or not isinstance(Dom, xml.dom.Node): |
50 | return "" |
51 | |
52 | if String[0] == "/": |
53 | String = String[1:] |
54 | |
55 | if Dom.nodeType==Dom.DOCUMENT_NODE: |
56 | Dom = Dom.documentElement |
57 | |
58 | tagList = String.split('/') |
59 | childNodes = [Dom] |
60 | index = 0 |
61 | end = len(tagList) - 1 |
62 | while index <= end: |
63 | for node in childNodes: |
64 | if node.nodeType == node.ELEMENT_NODE and node.tagName == tagList[index]: |
65 | if index < end: |
66 | childNodes = node.childNodes |
67 | else: |
68 | return node |
69 | break |
70 | |
71 | index += 1 |
72 | |
73 | return "" |
74 | |
75 | def XmlElementData (Dom): |
76 | """Get the text for this element.""" |
77 | if Dom == None or Dom == '' or Dom.firstChild == None: |
78 | return '' |
79 | |
80 | return Dom.firstChild.data.strip(' ') |
81 | |
82 | def XmlAttribute (Dom, String): |
83 | """Return a single attribute that named by String.""" |
84 | if Dom == None or Dom == '': |
85 | return '' |
86 | |
87 | try: |
88 | return Dom.getAttribute(String).strip(' ') |
89 | except: |
90 | return '' |
91 | |
92 | def XmlTopTag(Dom): |
93 | """Return the name of the Root or top tag in the XML tree.""" |
94 | if Dom == None or Dom == '' or Dom.firstChild == None: |
95 | return '' |
96 | return Dom.firstChild.nodeName |
97 | |
98 | |
99 | # This acts like the main() function for the script, unless it is 'import'ed into another |
100 | # script. |
101 | if __name__ == '__main__': |
102 | |
103 | # Nothing to do here. Could do some unit tests. |
104 | pass |