from __future__ import absolute_import import logging from lxml import etree from xblock.fields import Scope, String from xmodule.editing_module import XMLEditingDescriptor from xmodule.xml_module import XmlDescriptor from .exceptions import SerializationError log = logging.getLogger(__name__) class RawMixin(object): """ Common code between RawDescriptor and XBlocks converted from XModules. """ resources_dir = None data = String(help="XML data for the module", default="", scope=Scope.content) @classmethod def definition_from_xml(cls, xml_object, system): return {'data': etree.tostring(xml_object, pretty_print=True, encoding='unicode')}, [] def definition_to_xml(self, resource_fs): """ Return an Element if we've kept the import OLX, or None otherwise. """ # If there's no self.data, it means that an XBlock/XModule originally # existed for this data at the time of import/editing, but was later # uninstalled. RawDescriptor therefore never got to preserve the # original OLX that came in, and we have no idea how it should be # serialized for export. It's possible that we could do some smarter # fallback here and attempt to extract the data, but it's reasonable # and simpler to just skip this node altogether. if not self.data: log.warning( "Could not serialize %s: No XBlock installed for '%s' tag.", self.location, self.location.block_type, ) return None # Normal case: Just echo back the original OLX we saved. try: return etree.fromstring(self.data) except etree.XMLSyntaxError as err: # Can't recover here, so just add some info and # re-raise lines = self.data.split('\n') line, offset = err.position msg = ( u"Unable to create xml for module {loc}. " u"Context: '{context}'" ).format( context=lines[line - 1][offset - 40:offset + 40], loc=self.location, ) raise SerializationError(self.location, msg) class RawDescriptor(RawMixin, XmlDescriptor, XMLEditingDescriptor): """ Module that provides a raw editing view of its data and children. It requires that the definition xml is valid. """ pass class EmptyDataRawMixin(object): """ Common code between EmptyDataRawDescriptor and XBlocks converted from XModules. """ resources_dir = None data = String(default='', scope=Scope.content) @classmethod def definition_from_xml(cls, xml_object, system): if len(xml_object) == 0 and len(list(xml_object.items())) == 0: return {'data': ''}, [] return {'data': etree.tostring(xml_object, pretty_print=True, encoding='unicode')}, [] def definition_to_xml(self, resource_fs): if self.data: return etree.fromstring(self.data) return etree.Element(self.category) class EmptyDataRawDescriptor(EmptyDataRawMixin, XmlDescriptor, XMLEditingDescriptor): """ Version of RawDescriptor for modules which may have no XML data, but use XMLEditingDescriptor for import/export handling. """ pass