105 lines
3.1 KiB
Python
105 lines
3.1 KiB
Python
# This program is free software; you can redistribute it and/or modify it under
|
|
# the terms of the (LGPL) GNU Lesser General Public License as published by the
|
|
# Free Software Foundation; either version 3 of the License, or (at your
|
|
# option) any later version.
|
|
#
|
|
# This program is distributed in the hope that it will be useful, but WITHOUT
|
|
# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
|
|
# FOR A PARTICULAR PURPOSE. See the GNU Library Lesser General Public License
|
|
# for more details at ( http://www.gnu.org/licenses/lgpl.html ).
|
|
#
|
|
# You should have received a copy of the GNU Lesser General Public License
|
|
# along with this program; if not, write to the Free Software Foundation, Inc.,
|
|
# 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
|
|
# written by: Jeff Ortel ( jortel@redhat.com )
|
|
|
|
"""
|
|
The sax module contains a collection of classes that provide a (D)ocument
|
|
(O)bject (M)odel representation of an XML document. The goal is to provide an
|
|
easy, intuitive interface for managing XML documents. Although the term DOM is
|
|
used here, this model is B{far} better.
|
|
|
|
XML namespaces in suds are represented using a (2) element tuple containing the
|
|
prefix and the URI, e.g. I{('tns', 'http://myns')}
|
|
|
|
@var encoder: A I{pluggable} XML special character processor used to encode/
|
|
decode strings.
|
|
@type encoder: L{Encoder}
|
|
|
|
"""
|
|
|
|
from suds.sax.enc import Encoder
|
|
|
|
# pluggable XML special character encoder.
|
|
encoder = Encoder()
|
|
|
|
|
|
def splitPrefix(name):
|
|
"""
|
|
Split the name into a tuple (I{prefix}, I{name}). The first element in the
|
|
tuple is I{None} when the name does not have a prefix.
|
|
|
|
@param name: A node name containing an optional prefix.
|
|
@type name: basestring
|
|
@return: A tuple containing the (2) parts of I{name}.
|
|
@rtype: (I{prefix}, I{name})
|
|
|
|
"""
|
|
if isinstance(name, basestring) and ":" in name:
|
|
return tuple(name.split(":", 1))
|
|
return None, name
|
|
|
|
|
|
class Namespace:
|
|
"""XML namespace."""
|
|
|
|
default = (None, None)
|
|
xmlns = ("xml", "http://www.w3.org/XML/1998/namespace")
|
|
xsdns = ("xs", "http://www.w3.org/2001/XMLSchema")
|
|
xsins = ("xsi", "http://www.w3.org/2001/XMLSchema-instance")
|
|
all = (xsdns, xsins)
|
|
|
|
@classmethod
|
|
def create(cls, p=None, u=None):
|
|
return p, u
|
|
|
|
@classmethod
|
|
def none(cls, ns):
|
|
return ns == cls.default
|
|
|
|
@classmethod
|
|
def xsd(cls, ns):
|
|
try:
|
|
return cls.w3(ns) and ns[1].endswith("XMLSchema")
|
|
except Exception:
|
|
pass
|
|
return False
|
|
|
|
@classmethod
|
|
def xsi(cls, ns):
|
|
try:
|
|
return cls.w3(ns) and ns[1].endswith("XMLSchema-instance")
|
|
except Exception:
|
|
pass
|
|
return False
|
|
|
|
@classmethod
|
|
def xs(cls, ns):
|
|
return cls.xsd(ns) or cls.xsi(ns)
|
|
|
|
@classmethod
|
|
def w3(cls, ns):
|
|
try:
|
|
return ns[1].startswith("http://www.w3.org")
|
|
except Exception:
|
|
pass
|
|
return False
|
|
|
|
@classmethod
|
|
def isns(cls, ns):
|
|
try:
|
|
return isinstance(ns, tuple) and len(ns) == len(cls.default)
|
|
except Exception:
|
|
pass
|
|
return False
|