shebangs need to point at python2
[sfa.git] / sfa / rspecs / rspec.py
index f2fa662..fdd9c95 100755 (executable)
-#!/usr/bin/python 
-from lxml import etree
-from StringIO import StringIO
+#!/usr/bin/env python2
+
+from __future__ import print_function
+
 from datetime import datetime, timedelta
-from sfa.util.xrn import *
-from sfa.util.plxrn import hostname_to_urn
-from sfa.util.faults import SfaNotImplemented, InvalidRSpec
+
+from sfa.util.xml import XML, XpathFilter
+from sfa.util.faults import InvalidRSpecElement, InvalidRSpec
+from sfa.util.sfatime import SFATIME_FORMAT
+
+from sfa.rspecs.rspec_elements import RSpecElement, RSpecElements
+from sfa.rspecs.version_manager import VersionManager
+
 
 class RSpec:
-    header = '<?xml version="1.0"?>\n'
-    template = """<RSpec></RSpec>"""
-    xml = None
-    type = None
-    version = None
-    namespaces = None
-    user_options = {}
-  
-    def __init__(self, rspec="", namespaces={}, type=None, user_options={}):
-        self.type = type
+
+    def __init__(self, rspec="", version=None, user_options=None, ttl=None, expires=None):
+        if user_options is None:
+            user_options = {}
+        self.header = '<?xml version="1.0"?>\n'
+        self.template = """<RSpec></RSpec>"""
+        self.version = None
+        self.xml = XML()
+        self.version_manager = VersionManager()
         self.user_options = user_options
+        self.ttl = ttl
+        self.expires = expires
+        self.elements = {}
         if rspec:
-            self.parse_rspec(rspec, namespaces)
+            if version:
+                self.version = self.version_manager.get_version(version)
+                self.parse_xml(rspec, version)
+            else:
+                self.parse_xml(rspec)
+        elif version:
+            self.create(version, ttl, expires)
         else:
-            self.create()
+            raise InvalidRSpec(
+                "No RSpec or version specified. Must specify a valid rspec string or a valid version")
 
-    def create(self):
+    def create(self, version=None, ttl=None, expires=None):
         """
         Create root element
+        ttl: time to live in minutes, this will determine the expires tag of the RSpec
         """
-        # eg. 2011-03-23T19:53:28Z 
-        date_format = '%Y-%m-%dT%H:%M:%SZ'
+        self.version = self.version_manager.get_version(version)
+        self.namespaces = self.version.namespaces
+        self.parse_xml(self.version.template, self.version)
         now = datetime.utcnow()
-        generated_ts = now.strftime(date_format)
-        expires_ts = (now + timedelta(hours=1)).strftime(date_format) 
-        self.parse_rspec(self.template, self.namespaces)
+        generated_ts = now.strftime(SFATIME_FORMAT)
+        if ttl is None:
+            ttl = 60
+        if expires is None:
+            expires_ts = (now + timedelta(minutes=ttl)
+                          ).strftime(SFATIME_FORMAT)
+        else:
+            if isinstance(expires, int):
+                expires_date = datetime.fromtimestamp(expires)
+            else:
+                expires_date = expires
+            expires_ts = expires_date.strftime(SFATIME_FORMAT)
         self.xml.set('expires', expires_ts)
         self.xml.set('generated', generated_ts)
-    
-    def parse_rspec(self, rspec, namespaces={}):
-        """
-        parse rspec into etree
-        """
-        parser = etree.XMLParser(remove_blank_text=True)
-        try:
-            tree = etree.parse(rspec, parser)
-        except IOError:
-            # 'rspec' file doesnt exist. 'rspec' is proably an xml string
-            try:
-                tree = etree.parse(StringIO(rspec), parser)
-            except Exception, e:
-                raise InvalidRSpec(str(e))
-        self.xml = tree.getroot()  
-        if namespaces:
-           self.namespaces = namespaces
-
-    def xpath(self, xpath):
-        return this.xml.xpath(xpath, namespaces=self.namespaces)
-
-    def add_attribute(self, elem, name, value):
-        """
-        Add attribute to specified etree element    
-        """
-        opt = etree.SubElement(elem, name)
-        opt.text = value
 
-    def add_element(self, name, attrs={}, parent=None, text=""):
-        """
-        Generic wrapper around etree.SubElement(). Adds an element to 
-        specified parent node. Adds element to root node is parent is 
-        not specified. 
-        """
-        if parent == None:
-            parent = self.xml
-        element = etree.SubElement(parent, name)
-        if text:
-            element.text = text
-        if isinstance(attrs, dict):
-            for attr in attrs:
-                element.set(attr, attrs[attr])  
-        return element
-
-    def remove_attribute(self, elem, name, value):
-        """
-        Removes an attribute from an element
-        """
-        if elem is not None:
-            opts = elem.iterfind(name)
-            if opts is not None:
-                for opt in opts:
-                    if opt.text == value:
-                        elem.remove(opt)
-
-    def remove_element(self, element_name, root_node = None):
-        """
-        Removes all occurences of an element from the tree. Start at 
-        specified root_node if specified, otherwise start at tree's root.   
-        """
-        if not root_node:
-            root_node = self.xml
+    def parse_xml(self, xml, version=None):
+        self.xml.parse_xml(xml)
+        if not version:
+            if self.xml.schema:
+                self.version = self.version_manager.get_version_by_schema(
+                    self.xml.schema)
+            else:
+                #raise InvalidRSpec('unknown rspec schema: {}'.format(schema))
+                # TODO: Should start raising an exception once SFA defines a schema.
+                # for now we just  default to sfa
+                self.version = self.version_manager.get_version(
+                    {'type': 'sfa', 'version': '1'})
+        self.version.xml = self.xml
+        self.namespaces = self.xml.namespaces
+
+    def load_rspec_elements(self, rspec_elements):
+        self.elements = {}
+        for rspec_element in rspec_elements:
+            if isinstance(rspec_element, RSpecElement):
+                self.elements[rspec_element.type] = rspec_element
+
+    def register_rspec_element(self, element_type, element_name, element_path):
+        if element_type not in RSpecElements:
+            raise InvalidRSpecElement(element_type,
+                                      extra="no such element type: {}. Must specify a valid RSpecElement".format(element_type))
+        self.elements[element_type] = RSpecElement(
+            element_type, element_name, element_path)
 
-        if not element_name.startswith('//'):
-            element_name = '//' + element_name
+    def get_rspec_element(self, element_type):
+        if element_type not in self.elements:
+            msg = "ElementType {} not registered for this rspec".format(
+                element_type)
+            raise InvalidRSpecElement(element_type, extra=msg)
+        return self.elements[element_type]
 
-        elements = root_node.xpath('%s ' % element_name, namespaces=self.namespaces)
-        for element in elements:
-            parent = element.getparent()
-            parent.remove(element)
-         
+    def get(self, element_type, filter=None, depth=0):
+        if filter is None:
+            filter = {}
+        elements = self.get_elements(element_type, filter)
+        elements = [self.xml.get_element_attributes(
+            elem, depth=depth) for elem in elements]
+        return elements
+
+    def get_elements(self, element_type, filter=None):
+        """
+        search for a registered element
+        """
+        if filter is None:
+            filter = {}
+        if element_type not in self.elements:
+            msg = "Unable to search for element {} in rspec, expath expression not found."\
+                  .format(element_type)
+            raise InvalidRSpecElement(element_type, extra=msg)
+        rspec_element = self.get_rspec_element(element_type)
+        xpath = rspec_element.path + XpathFilter.xpath(filter)
+        return self.xml.xpath(xpath)
 
     def merge(self, in_rspec):
-        pass
+        self.version.merge(in_rspec)
 
-    def validate(self, schema):
-        """
-        Validate against rng schema
-        """
-        
-        relaxng_doc = etree.parse(schema)
-        relaxng = etree.RelaxNG(relaxng_doc)
-        if not relaxng(self.xml):
-            error = relaxng.error_log.last_error
-            message = "%s (line %s)" % (error.message, error.line)
-            raise InvalidRSpec(message)
-        return True
-        
-    def cleanup(self):
-        """
-        Optional method which inheriting classes can choose to implent. 
-        """
-        pass 
+    def filter(self, filter):
+        if 'component_manager_id' in filter:
+            nodes = self.version.get_nodes()
+            for node in nodes:
+                if 'component_manager_id' not in node.attrib or \
+                        node.attrib['component_manager_id'] != filter['component_manager_id']:
+                    parent = node.getparent()
+                    parent.remove(node.element)
+
+    def toxml(self, header=True):
+        if header:
+            return self.header + self.xml.toxml()
+        else:
+            return self.xml.toxml()
 
-    def _process_slivers(self, slivers):
-        """
-        Creates a dict of sliver details for each sliver host
-        
-        @param slivers a single hostname, list of hostanmes or list of dicts keys on hostname,
-        Returns a list of dicts 
-        """
-        if not isinstance(slivers, list):
-            slivers = [slivers]
-        dicts = []
-        for sliver in slivers:
-            if isinstance(sliver, dict):
-                dicts.append(sliver)
-            elif isinstance(sliver, basestring):
-                dicts.append({'hostname': sliver}) 
-        return dicts
-
-    def __str__(self):
-        return self.toxml()
-
-    def toxml(self, cleanup=False):
-        if cleanup:
-            self.cleanup()
-        return self.header + etree.tostring(self.xml, pretty_print=True)  
-        
     def save(self, filename):
-        f = open(filename, 'w')
-        f.write(self.toxml())
-        f.close()
+        return self.xml.save(filename)
+
 if __name__ == '__main__':
-    rspec = RSpec()
-    print rspec
+    import sys
+    input = sys.argv[1]
+    with open(input) as f:
+        rspec = RSpec(f.read())
+    print(rspec)
+#    rspec.register_rspec_element(RSpecElements.NETWORK, 'network', '//network')
+#    rspec.register_rspec_element(RSpecElements.NODE, 'node', '//node')
+#    print rspec.get(RSpecElements.NODE)[0]
+#    print rspec.get(RSpecElements.NODE, depth=1)[0]