377 lines
13 KiB
Python
377 lines
13 KiB
Python
import copy
|
|
import logging
|
|
from collections import OrderedDict, deque
|
|
from itertools import chain
|
|
|
|
from cached_property import threaded_cached_property
|
|
|
|
from zeep.exceptions import UnexpectedElementError, XMLParseError
|
|
from zeep.xsd.const import xsi_ns, SkipValue, NotSet
|
|
from zeep.xsd.elements import (
|
|
Any, AnyAttribute, AttributeGroup, Choice, Element, Group, Sequence)
|
|
from zeep.xsd.elements.indicators import OrderIndicator
|
|
from zeep.xsd.types.any import AnyType
|
|
from zeep.xsd.types.simple import AnySimpleType
|
|
from zeep.xsd.utils import NamePrefixGenerator
|
|
from zeep.xsd.valueobjects import CompoundValue
|
|
|
|
logger = logging.getLogger(__name__)
|
|
|
|
__all__ = ['ComplexType']
|
|
|
|
|
|
class ComplexType(AnyType):
|
|
_xsd_name = None
|
|
|
|
def __init__(self, element=None, attributes=None,
|
|
restriction=None, extension=None, qname=None, is_global=False):
|
|
if element and type(element) == list:
|
|
element = Sequence(element)
|
|
|
|
self.name = self.__class__.__name__ if qname else None
|
|
self._element = element
|
|
self._attributes = attributes or []
|
|
self._restriction = restriction
|
|
self._extension = extension
|
|
super(ComplexType, self).__init__(qname=qname, is_global=is_global)
|
|
|
|
def __call__(self, *args, **kwargs):
|
|
return self._value_class(*args, **kwargs)
|
|
|
|
@property
|
|
def accepted_types(self):
|
|
return (self._value_class,)
|
|
|
|
@threaded_cached_property
|
|
def _value_class(self):
|
|
return type(
|
|
self.__class__.__name__, (CompoundValue,),
|
|
{'_xsd_type': self, '__module__': 'zeep.objects'})
|
|
|
|
def __str__(self):
|
|
return '%s(%s)' % (self.__class__.__name__, self.signature())
|
|
|
|
@threaded_cached_property
|
|
def attributes(self):
|
|
generator = NamePrefixGenerator(prefix='_attr_')
|
|
result = []
|
|
elm_names = {name for name, elm in self.elements if name is not None}
|
|
for attr in self._attributes_unwrapped:
|
|
if attr.name is None:
|
|
name = generator.get_name()
|
|
elif attr.name in elm_names:
|
|
name = 'attr__%s' % attr.name
|
|
else:
|
|
name = attr.name
|
|
result.append((name, attr))
|
|
return result
|
|
|
|
@threaded_cached_property
|
|
def _attributes_unwrapped(self):
|
|
attributes = []
|
|
for attr in self._attributes:
|
|
if isinstance(attr, AttributeGroup):
|
|
attributes.extend(attr.attributes)
|
|
else:
|
|
attributes.append(attr)
|
|
return attributes
|
|
|
|
@threaded_cached_property
|
|
def elements(self):
|
|
"""List of tuples containing the element name and the element"""
|
|
result = []
|
|
for name, element in self.elements_nested:
|
|
if isinstance(element, Element):
|
|
result.append((element.attr_name, element))
|
|
else:
|
|
result.extend(element.elements)
|
|
return result
|
|
|
|
@threaded_cached_property
|
|
def elements_nested(self):
|
|
"""List of tuples containing the element name and the element"""
|
|
result = []
|
|
generator = NamePrefixGenerator()
|
|
|
|
# Handle wsdl:arrayType objects
|
|
attrs = {attr.qname.text: attr for attr in self._attributes if attr.qname}
|
|
array_type = attrs.get('{http://schemas.xmlsoap.org/soap/encoding/}arrayType')
|
|
if array_type:
|
|
name = generator.get_name()
|
|
if isinstance(self._element, Group):
|
|
return [(name, Sequence([
|
|
Any(max_occurs='unbounded', restrict=array_type.array_type)
|
|
]))]
|
|
else:
|
|
return [(name, self._element)]
|
|
|
|
# _element is one of All, Choice, Group, Sequence
|
|
if self._element:
|
|
result.append((generator.get_name(), self._element))
|
|
return result
|
|
|
|
def parse_xmlelement(self, xmlelement, schema, allow_none=True,
|
|
context=None):
|
|
"""Consume matching xmlelements and call parse() on each"""
|
|
# If this is an empty complexType (<xsd:complexType name="x"/>)
|
|
if not self.attributes and not self.elements:
|
|
return None
|
|
|
|
attributes = xmlelement.attrib
|
|
init_kwargs = OrderedDict()
|
|
|
|
# If this complexType extends a simpleType then we have no nested
|
|
# elements. Parse it directly via the type object. This is the case
|
|
# for xsd:simpleContent
|
|
if isinstance(self._element, Element) and isinstance(self._element.type, AnySimpleType):
|
|
name, element = self.elements_nested[0]
|
|
init_kwargs[name] = element.type.parse_xmlelement(
|
|
xmlelement, schema, name, context=context)
|
|
else:
|
|
elements = deque(xmlelement.iterchildren())
|
|
if allow_none and len(elements) == 0 and len(attributes) == 0:
|
|
return
|
|
|
|
# Parse elements. These are always indicator elements (all, choice,
|
|
# group, sequence)
|
|
for name, element in self.elements_nested:
|
|
try:
|
|
result = element.parse_xmlelements(
|
|
elements, schema, name, context=context)
|
|
if result:
|
|
init_kwargs.update(result)
|
|
except UnexpectedElementError as exc:
|
|
raise XMLParseError(exc.message)
|
|
|
|
# Check if all children are consumed (parsed)
|
|
if elements:
|
|
raise XMLParseError("Unexpected element %r" % elements[0].tag)
|
|
|
|
# Parse attributes
|
|
if attributes:
|
|
attributes = copy.copy(attributes)
|
|
for name, attribute in self.attributes:
|
|
if attribute.name:
|
|
if attribute.qname.text in attributes:
|
|
value = attributes.pop(attribute.qname.text)
|
|
init_kwargs[name] = attribute.parse(value)
|
|
else:
|
|
init_kwargs[name] = attribute.parse(attributes)
|
|
|
|
return self(**init_kwargs)
|
|
|
|
def render(self, parent, value, xsd_type=None, render_path=None):
|
|
"""Serialize the given value lxml.Element subelements on the parent
|
|
element.
|
|
|
|
"""
|
|
if not render_path:
|
|
render_path = [self.name]
|
|
|
|
if not self.elements_nested and not self.attributes:
|
|
return
|
|
|
|
# Render attributes
|
|
for name, attribute in self.attributes:
|
|
attr_value = value[name] if name in value else NotSet
|
|
child_path = render_path + [name]
|
|
attribute.render(parent, attr_value, child_path)
|
|
|
|
# Render sub elements
|
|
for name, element in self.elements_nested:
|
|
if isinstance(element, Element) or element.accepts_multiple:
|
|
element_value = value[name] if name in value else NotSet
|
|
child_path = render_path + [name]
|
|
else:
|
|
element_value = value
|
|
child_path = list(render_path)
|
|
|
|
if element_value is SkipValue:
|
|
continue
|
|
|
|
if isinstance(element, Element):
|
|
element.type.render(parent, element_value, None, child_path)
|
|
else:
|
|
element.render(parent, element_value, child_path)
|
|
|
|
if xsd_type:
|
|
if xsd_type._xsd_name:
|
|
parent.set(xsi_ns('type'), xsd_type._xsd_name)
|
|
if xsd_type.qname:
|
|
parent.set(xsi_ns('type'), xsd_type.qname)
|
|
|
|
def parse_kwargs(self, kwargs, name, available_kwargs):
|
|
value = None
|
|
name = name or self.name
|
|
|
|
if name in available_kwargs:
|
|
value = kwargs[name]
|
|
available_kwargs.remove(name)
|
|
|
|
value = self._create_object(value, name)
|
|
return {name: value}
|
|
return {}
|
|
|
|
def _create_object(self, value, name):
|
|
"""Return the value as a CompoundValue object"""
|
|
if value is None:
|
|
return None
|
|
|
|
if isinstance(value, list):
|
|
return [self._create_object(val, name) for val in value]
|
|
|
|
if isinstance(value, CompoundValue):
|
|
return value
|
|
|
|
if isinstance(value, dict):
|
|
return self(**value)
|
|
|
|
# Check if the valueclass only expects one value, in that case
|
|
# we can try to automatically create an object for it.
|
|
if len(self.attributes) + len(self.elements) == 1:
|
|
return self(value)
|
|
|
|
raise ValueError((
|
|
"Error while create XML for complexType '%s': "
|
|
"Expected instance of type %s, received %r instead."
|
|
) % (self.qname or name, self._value_class, type(value)))
|
|
|
|
def resolve(self):
|
|
"""Resolve all sub elements and types"""
|
|
if self._resolved:
|
|
return self._resolved
|
|
self._resolved = self
|
|
|
|
if self._element:
|
|
self._element = self._element.resolve()
|
|
|
|
resolved = []
|
|
for attribute in self._attributes:
|
|
value = attribute.resolve()
|
|
assert value is not None
|
|
if isinstance(value, list):
|
|
resolved.extend(value)
|
|
else:
|
|
resolved.append(value)
|
|
self._attributes = resolved
|
|
|
|
if self._extension:
|
|
self._extension = self._extension.resolve()
|
|
self._resolved = self.extend(self._extension)
|
|
return self._resolved
|
|
|
|
elif self._restriction:
|
|
self._restriction = self._restriction.resolve()
|
|
self._resolved = self.restrict(self._restriction)
|
|
return self._resolved
|
|
|
|
else:
|
|
return self._resolved
|
|
|
|
def extend(self, base):
|
|
"""Create a new complextype instance which is the current type
|
|
extending the given base type.
|
|
|
|
Used for handling xsd:extension tags
|
|
|
|
TODO: Needs a rewrite where the child containers are responsible for
|
|
the extend functionality.
|
|
|
|
"""
|
|
if isinstance(base, ComplexType):
|
|
base_attributes = base._attributes_unwrapped
|
|
base_element = base._element
|
|
else:
|
|
base_attributes = []
|
|
base_element = None
|
|
attributes = base_attributes + self._attributes_unwrapped
|
|
|
|
# Make sure we don't have duplicate (child is leading)
|
|
if base_attributes and self._attributes_unwrapped:
|
|
new_attributes = OrderedDict()
|
|
for attr in attributes:
|
|
if isinstance(attr, AnyAttribute):
|
|
new_attributes['##any'] = attr
|
|
else:
|
|
new_attributes[attr.qname.text] = attr
|
|
attributes = new_attributes.values()
|
|
|
|
# If the base and the current type both have an element defined then
|
|
# these need to be merged. The base_element might be empty (or just
|
|
# container a placeholder element).
|
|
element = []
|
|
if self._element and base_element:
|
|
element = self._element.clone(self._element.name)
|
|
if isinstance(base_element, OrderIndicator):
|
|
if isinstance(self._element, Choice):
|
|
element = base_element.clone(self._element.name)
|
|
element.append(self._element)
|
|
elif isinstance(element, OrderIndicator):
|
|
for item in reversed(base_element):
|
|
element.insert(0, item)
|
|
|
|
elif isinstance(self._element, Group):
|
|
raise NotImplementedError('TODO')
|
|
else:
|
|
pass # Element (ignore for now)
|
|
|
|
elif self._element or base_element:
|
|
element = self._element or base_element
|
|
else:
|
|
element = Element('_value_1', base)
|
|
|
|
new = self.__class__(
|
|
element=element,
|
|
attributes=attributes,
|
|
qname=self.qname)
|
|
return new
|
|
|
|
def restrict(self, base):
|
|
"""Create a new complextype instance which is the current type
|
|
restricted by the base type.
|
|
|
|
Used for handling xsd:restriction
|
|
|
|
"""
|
|
attributes = list(
|
|
chain(base._attributes_unwrapped, self._attributes_unwrapped))
|
|
|
|
# Make sure we don't have duplicate (self is leading)
|
|
if base._attributes_unwrapped and self._attributes_unwrapped:
|
|
new_attributes = OrderedDict()
|
|
for attr in attributes:
|
|
if isinstance(attr, AnyAttribute):
|
|
new_attributes['##any'] = attr
|
|
else:
|
|
new_attributes[attr.qname.text] = attr
|
|
attributes = new_attributes.values()
|
|
|
|
new = self.__class__(
|
|
element=self._element or base._element,
|
|
attributes=attributes,
|
|
qname=self.qname)
|
|
return new.resolve()
|
|
|
|
def signature(self, depth=()):
|
|
if len(depth) > 0 and self.is_global:
|
|
return self.name
|
|
|
|
parts = []
|
|
depth += (self.name,)
|
|
for name, element in self.elements_nested:
|
|
# http://schemas.xmlsoap.org/soap/encoding/ contains cyclic type
|
|
if isinstance(element, Element) and element.type == self:
|
|
continue
|
|
|
|
part = element.signature(depth)
|
|
parts.append(part)
|
|
|
|
for name, attribute in self.attributes:
|
|
part = '%s: %s' % (name, attribute.signature(depth))
|
|
parts.append(part)
|
|
|
|
value = ', '.join(parts)
|
|
if len(depth) > 1:
|
|
value = '{%s}' % value
|
|
return value
|