sfa/rspecs/xml_interface.py

   1 #!/usr/bin/python
   2 from lxml import etree
   3 from StringIO import StringIO
   4 from datetime import datetime, timedelta
   5 from sfa.util.xrn import *
   6 from sfa.util.plxrn import hostname_to_urn
   7 from sfa.util.faults import SfaNotImplemented, InvalidRSpec, InvalidRSpecElement
   8
   9 class XpathFilter:
  10     @staticmethod
  11     def xpath(filter={}):
  12         xpath = ""
  13         if filter:
  14             filter_list = []
  15             for (key, value) in filter.items():
  16                 if key == 'text':
  17                     key = 'text()'
  18                 else:
  19                     key = '@'+key
  20                 if isinstance(value, str):
  21                     filter_list.append('%s="%s"' % (key, value))
  22                 elif isinstance(value, list):
  23                     filter_list.append('contains("%s", %s)' % (' '.join(map(str, value)), key))
  24             if filter_list:
  25                 xpath = ' and '.join(filter_list)
  26                 xpath = '[' + xpath + ']'
  27         return xpath
  28
  29 class XMLInterface:
  30
  31     def __init__(self, xml=""):
  32         self.header = None
  33         self.template = None
  34         self.xml = None
  35         self.namespaces = None
  36         if xml:
  37             self.parse_xml(xml)
  38         else:
  39             self.create()
  40
  41     def create(self):
  42         """
  43         Create root element
  44         """
  45         self.parse_rspec(self.template)
  46
  47     def parse_xml(self, xml):
  48         """
  49         parse rspec into etree
  50         """
  51         parser = etree.XMLParser(remove_blank_text=True)
  52         try:
  53             tree = etree.parse(xml, parser)
  54         except IOError:
  55             # 'rspec' file doesnt exist. 'rspec' is proably an xml string
  56             try:
  57                 tree = etree.parse(StringIO(xml), parser)
  58             except Exception, e:
  59                 raise InvalidRSpec(str(e))
  60         self.xml = tree.getroot()
  61
  62     def validate(self, schema):
  63         """
  64         Validate against rng schema
  65         """
  66         relaxng_doc = etree.parse(schema)
  67         relaxng = etree.RelaxNG(relaxng_doc)
  68         if not relaxng(self.xml):
  69             error = relaxng.error_log.last_error
  70             message = "%s (line %s)" % (error.message, error.line)
  71             raise InvalidRSpec(message)
  72         return True
  73
  74     def xpath(self, xpath):
  75         return self.xml.xpath(xpath, namespaces=self.namespaces)
  76
  77     def add_attribute(self, elem, name, value):
  78         """
  79         Add attribute to specified etree element
  80         """
  81         opt = etree.SubElement(elem, name)
  82         opt.text = value
  83
  84     def add_element(self, name, attrs={}, parent=None, text=""):
  85         """
  86         Generic wrapper around etree.SubElement(). Adds an element to
  87         specified parent node. Adds element to root node is parent is
  88         not specified.
  89         """
  90         if parent == None:
  91             parent = self.xml
  92         element = etree.SubElement(parent, name)
  93         if text:
  94             element.text = text
  95         if isinstance(attrs, dict):
  96             for attr in attrs:
  97                 element.set(attr, attrs[attr])
  98         return element
  99
 100     def remove_attribute(self, elem, name, value):
 101         """
 102         Removes an attribute from an element
 103         """
 104         if elem is not None:
 105             opts = elem.iterfind(name)
 106             if opts is not None:
 107                 for opt in opts:
 108                     if opt.text == value:
 109                         elem.remove(opt)
 110
 111     def remove_element(self, element_name, root_node = None):
 112         """
 113         Removes all occurences of an element from the tree. Start at
 114         specified root_node if specified, otherwise start at tree's root.
 115         """
 116         if not root_node:
 117             root_node = self.xml
 118
 119         if not element_name.startswith('//'):
 120             element_name = '//' + element_name
 121
 122         elements = root_node.xpath('%s ' % element_name, namespaces=self.namespaces)
 123         for element in elements:
 124             parent = element.getparent()
 125             parent.remove(element)
 126
 127     def attributes_list(self, elem):
 128         # convert a list of attribute tags into list of tuples
 129         # (tagnme, text_value)
 130         opts = []
 131         if elem is not None:
 132             for e in elem:
 133                 opts.append((e.tag, str(e.text).strip()))
 134         return opts
 135
 136     def get_element_attributes(self, elem=None, depth=0):
 137         if elem == None:
 138             elem = self.root_node
 139         if not hasattr(elem, 'attrib'):
 140             # this is probably not an element node with attribute. could be just and an
 141             # attribute, return it
 142             return elem
 143         attrs = dict(elem.attrib)
 144         attrs['text'] = str(elem.text).strip()
 145         attrs['parent'] = elem.getparent()
 146         if isinstance(depth, int) and depth > 0:
 147             for child_elem in list(elem):
 148                 key = str(child_elem.tag)
 149                 if key not in attrs:
 150                     attrs[key] = [self.get_element_attributes(child_elem, depth-1)]
 151                 else:
 152                     attrs[key].append(self.get_element_attributes(child_elem, depth-1))
 153         else:
 154             attrs['child_nodes'] = list(elem)
 155         return attrs
 156
 157     def merge(self, in_xml):
 158         pass
 159
 160     def cleanup(self):
 161         """
 162         Optional method which inheriting classes can choose to implent.
 163         """
 164         pass
 165
 166     def __str__(self):
 167         return self.toxml()
 168
 169     def toxml(self, cleanup=False):
 170         if cleanup:
 171             self.cleanup()
 172         return self.header + etree.tostring(self.xml, pretty_print=True)
 173
 174     def save(self, filename):
 175         f = open(filename, 'w')
 176         f.write(self.toxml())
 177         f.close()
 178
 179 if __name__ == '__main__':
 180     rspec = RSpec('/tmp/resources.rspec')
 181     print rspec
 182