test/vpp_object.py

   1 """ abstract vpp object and object registry """
   2
   3 from abc import ABCMeta, abstractmethod
   4
   5
   6 class VppObject(object):
   7     """ Abstract vpp object """
   8     __metaclass__ = ABCMeta
   9
  10     @abstractmethod
  11     def add_vpp_config(self):
  12         """ Add the configuration for this object to vpp. """
  13         pass
  14
  15     @abstractmethod
  16     def query_vpp_config(self):
  17         """Query the vpp configuration.
  18
  19         :return: True if the object is configured"""
  20         pass
  21
  22     @abstractmethod
  23     def remove_vpp_config(self):
  24         """ Remove the configuration for this object from vpp. """
  25         pass
  26
  27     @abstractmethod
  28     def object_id(self):
  29         """ Return a unique string representing this object. """
  30         pass
  31
  32
  33 class VppObjectRegistry(object):
  34     """ Class which handles automatic configuration cleanup. """
  35     _shared_state = {}
  36
  37     def __init__(self):
  38         self.__dict__ = self._shared_state
  39         if not hasattr(self, "_object_registry"):
  40             self._object_registry = []
  41         if not hasattr(self, "_object_dict"):
  42             self._object_dict = dict()
  43
  44     def register(self, obj, logger):
  45         """ Register an object in the registry. """
  46         if obj.object_id() not in self._object_dict:
  47             self._object_registry.append(obj)
  48             self._object_dict[obj.object_id()] = obj
  49             logger.debug("REG: registering %s" % obj)
  50         else:
  51             logger.debug("REG: duplicate add, ignoring (%s)" % obj)
  52
  53     def remove_vpp_config(self, logger):
  54         """
  55         Remove configuration (if present) from vpp and then remove all objects
  56         from the registry.
  57         """
  58         if not self._object_registry:
  59             logger.info("REG: No objects registered for auto-cleanup.")
  60             return
  61         logger.info("REG: Removing VPP configuration for registered objects")
  62         # remove the config in reverse order as there might be dependencies
  63         for obj in reversed(self._object_registry):
  64             if obj.query_vpp_config():
  65                 logger.info("REG: Removing configuration for %s" % obj)
  66                 obj.remove_vpp_config()
  67             else:
  68                 logger.info(
  69                     "REG: Skipping removal for %s, configuration not present" %
  70                     obj)
  71         failed = []
  72         for obj in self._object_registry:
  73             if obj.query_vpp_config():
  74                 failed.append(obj)
  75         self._object_registry = []
  76         self._object_dict = dict()
  77         if failed:
  78             logger.error("REG: Couldn't remove configuration for object(s):")
  79             for obj in failed:
  80                 logger.error(repr(obj))
  81             raise Exception("Couldn't remove configuration for object(s): %s" %
  82                             (", ".join(str(x) for x in failed)))