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
|
"""Namespace related objects."""
from __future__ import annotations
# -- Maps namespace prefix to namespace name for all known PowerPoint XML namespaces --
_nsmap = {
"a": "http://schemas.openxmlformats.org/drawingml/2006/main",
"c": "http://schemas.openxmlformats.org/drawingml/2006/chart",
"cp": "http://schemas.openxmlformats.org/package/2006/metadata/core-properties",
"ct": "http://schemas.openxmlformats.org/package/2006/content-types",
"dc": "http://purl.org/dc/elements/1.1/",
"dcmitype": "http://purl.org/dc/dcmitype/",
"dcterms": "http://purl.org/dc/terms/",
"ep": "http://schemas.openxmlformats.org/officeDocument/2006/extended-properties",
"i": "http://schemas.openxmlformats.org/officeDocument/2006/relationships/image",
"m": "http://schemas.openxmlformats.org/officeDocument/2006/math",
"mo": "http://schemas.microsoft.com/office/mac/office/2008/main",
"mv": "urn:schemas-microsoft-com:mac:vml",
"o": "urn:schemas-microsoft-com:office:office",
"p": "http://schemas.openxmlformats.org/presentationml/2006/main",
"pd": "http://schemas.openxmlformats.org/drawingml/2006/presentationDrawing",
"pic": "http://schemas.openxmlformats.org/drawingml/2006/picture",
"pr": "http://schemas.openxmlformats.org/package/2006/relationships",
"r": "http://schemas.openxmlformats.org/officeDocument/2006/relationships",
"sl": "http://schemas.openxmlformats.org/officeDocument/2006/relationships/slideLayout",
"v": "urn:schemas-microsoft-com:vml",
"ve": "http://schemas.openxmlformats.org/markup-compatibility/2006",
"w": "http://schemas.openxmlformats.org/wordprocessingml/2006/main",
"w10": "urn:schemas-microsoft-com:office:word",
"wne": "http://schemas.microsoft.com/office/word/2006/wordml",
"wp": "http://schemas.openxmlformats.org/drawingml/2006/wordprocessingDrawing",
"xsi": "http://www.w3.org/2001/XMLSchema-instance",
}
pfxmap = {value: key for key, value in _nsmap.items()}
class NamespacePrefixedTag(str):
"""Value object that knows the semantics of an XML tag having a namespace prefix."""
def __new__(cls, nstag: str):
return super(NamespacePrefixedTag, cls).__new__(cls, nstag)
def __init__(self, nstag: str):
self._pfx, self._local_part = nstag.split(":")
self._ns_uri = _nsmap[self._pfx]
@classmethod
def from_clark_name(cls, clark_name: str) -> NamespacePrefixedTag:
nsuri, local_name = clark_name[1:].split("}")
nstag = "%s:%s" % (pfxmap[nsuri], local_name)
return cls(nstag)
@property
def clark_name(self):
return "{%s}%s" % (self._ns_uri, self._local_part)
@property
def local_part(self):
"""
Return the local part of the tag as a string. E.g. 'foobar' is
returned for tag 'f:foobar'.
"""
return self._local_part
@property
def nsmap(self):
"""
Return a dict having a single member, mapping the namespace prefix of
this tag to it's namespace name (e.g. {'f': 'http://foo/bar'}). This
is handy for passing to xpath calls and other uses.
"""
return {self._pfx: self._ns_uri}
@property
def nspfx(self):
"""
Return the string namespace prefix for the tag, e.g. 'f' is returned
for tag 'f:foobar'.
"""
return self._pfx
@property
def nsuri(self):
"""
Return the namespace URI for the tag, e.g. 'http://foo/bar' would be
returned for tag 'f:foobar' if the 'f' prefix maps to
'http://foo/bar' in _nsmap.
"""
return self._ns_uri
def namespaces(*prefixes: str):
"""Return a dict containing the subset namespace prefix mappings specified by *prefixes*.
Any number of namespace prefixes can be supplied, e.g. namespaces('a', 'r', 'p').
"""
return {pfx: _nsmap[pfx] for pfx in prefixes}
nsmap = namespaces # alias for more compact use with Element()
def nsdecls(*prefixes: str):
return " ".join(['xmlns:%s="%s"' % (pfx, _nsmap[pfx]) for pfx in prefixes])
def nsuri(nspfx: str):
"""Return the namespace URI corresponding to `nspfx`.
Example:
>>> nsuri("p")
"http://schemas.openxmlformats.org/presentationml/2006/main"
"""
return _nsmap[nspfx]
def qn(namespace_prefixed_tag: str) -> str:
"""Return a Clark-notation qualified tag name corresponding to `namespace_prefixed_tag`.
`namespace_prefixed_tag` is a string like 'p:body'. 'qn' stands for `qualified name`.
As an example, `qn("p:cSld")` returns:
`"{http://schemas.openxmlformats.org/drawingml/2006/main}cSld"`.
"""
nsptag = NamespacePrefixedTag(namespace_prefixed_tag)
return nsptag.clark_name
|
