validator.py

   1 import os
   2 from zeroinstall.injector import model, namespaces
   3 from zeroinstall.injector.reader import InvalidInterface, update
   4 from xml.dom import minidom, Node, XMLNS_NAMESPACE
   5 import tempfile
   6 from logging import warn, info, debug
   7
   8 known_elements = {
   9         'interface' : ['uri', 'min-injector-version', 'main'],  # (main is deprecated)
  10         'name' : [],
  11         'summary' : [],
  12         'description' : [],
  13         'homepage' : [],
  14         'icon' : ['type', 'href'],
  15         'feed' : ['src', 'arch'],
  16         'feed-for' : ['interface'],
  17
  18         'group' : ['version', 'released', 'main', 'stability', 'arch'],
  19         'implementation' : ['id', 'version', 'released', 'main', 'stability', 'arch'],
  20         'archive' : ['href', 'size', 'extract', 'type', 'start-offset'],
  21         'recipe' : [],
  22         'requires' : ['interface'],
  23         'version' : ['not-before', 'before'],
  24         'environment' : ['name', 'insert', 'default'],
  25 }
  26
  27 def checkElement(elem):
  28         if elem.namespaceURI != namespaces.XMLNS_IFACE:
  29                 info("Note: Skipping unknown (but namespaced) element <%s>", elem.localName)
  30                 return  # Namespaces elements are OK
  31
  32         if elem.localName not in known_elements:
  33                 warn("Unknown Zero Install element <%s>.\nNon Zero-Install elements should be namespaced.", elem.localName)
  34                 return
  35
  36         known_attrs = known_elements[elem.localName]
  37
  38         for (uri, name), value in elem.attributes.itemsNS():
  39                 if uri == XMLNS_NAMESPACE:
  40                         continue        # Namespace declarations are fine
  41
  42                 if uri:
  43                         info("Note: Skipping unknown (but namespaced) attribute '%s'", name)
  44                         continue
  45
  46                 if name not in known_attrs:
  47                         warn("Unknown Zero Install attribute '%s' on <%s>.\nNon Zero-Install attributes should be namespaced.",
  48                                         name, elem.localName)
  49
  50         for child in elem.childNodes:
  51                 if child.nodeType == Node.ELEMENT_NODE:
  52                         checkElement(child)
  53
  54 def check(data, warnings = True):
  55         fd, tmp_name = tempfile.mkstemp(prefix = '0publish-validate-')
  56         os.close(fd)
  57         tmp_iface = model.Interface(tmp_name)
  58         try:
  59                 tmp_file = file(tmp_name, 'w')
  60                 tmp_file.write(data)
  61                 tmp_file.close()
  62                 try:
  63                         update(tmp_iface, tmp_name, local = True)
  64                 except InvalidInterface, ex:
  65                         raise
  66                 except Exception, ex:
  67                         warn("Internal error", ex)
  68                         raise InvalidInterface(str(ex))
  69         finally:
  70                 os.unlink(tmp_name)
  71
  72         if warnings:
  73                 doc = minidom.parseString(data)
  74                 checkElement(doc.documentElement)