Synnefo » snf-ganeti

from ganeti.rapi import connector

  def testRapiDocs(self):

    """Check whether all RAPI resources are documented.

    """

    rapidoc = self._ReadDocFile("rapi.rst")

    node_name = "[node_name]"

    instance_name = "[instance_name]"

    job_id = "[job_id]"

    resources = connector.GetHandlers(re.escape(node_name),

                                      re.escape(instance_name),

                                      re.escape(job_id))

    titles = []

    prevline = None

    for line in rapidoc.splitlines():

      if re.match(r"^\++$", line):

        titles.append(prevline)

      prevline = line

    undocumented = []

    for key, handler in resources.iteritems():

      # Regex objects

      if hasattr(key, "match"):

        found = False

        for title in titles:

          if (title.startswith("``") and

              title.endswith("``") and

              key.match(title[2:-2])):

            found = True

            break

        if not found:

          # TODO: Find better way of identifying resource

          undocumented.append(str(handler))

      elif ("``%s``" % key) not in titles:

        undocumented.append(key)

    self.failIf(undocumented,

                msg=("Missing RAPI resource documentation for %s" %

                     utils.CommaJoin(undocumented)))