-from abc import ABCMeta, abstractmethod
+""" abstract vpp object and object registry """
+import abc
-class VppObject(object):
- """ Abstract vpp object """
- __metaclass__ = ABCMeta
- def __init__(self):
- VppObjectRegistry().register(self)
+class VppObject(metaclass=abc.ABCMeta):
+ """ Abstract vpp object """
- @abstractmethod
- def add_vpp_config(self):
+ @abc.abstractmethod
+ def add_vpp_config(self) -> None:
""" Add the configuration for this object to vpp. """
pass
- @abstractmethod
- def query_vpp_config(self):
+ @abc.abstractmethod
+ def query_vpp_config(self) -> bool:
"""Query the vpp configuration.
:return: True if the object is configured"""
pass
- @abstractmethod
- def remove_vpp_config(self):
+ @abc.abstractmethod
+ def remove_vpp_config(self) -> None:
""" Remove the configuration for this object from vpp. """
pass
- @abstractmethod
- def object_id(self):
+ def object_id(self) -> str:
""" Return a unique string representing this object. """
- pass
+ return "Undefined. for <%s %s>" % (self.__class__.__name__, id(self))
+
+ def __str__(self) -> str:
+ return self.object_id()
+
+ def __repr__(self) -> str:
+ return '<%s>' % self.object_id()
+
+ def __hash__(self) -> int:
+ return hash(self.object_id())
+
+ def __eq__(self, other) -> bool:
+ if not isinstance(other, self.__class__):
+ return NotImplemented
+ if other.object_id() == self.object_id():
+ return True
+ return False
+
+ # This can be removed when python2 support is dropped.
+ def __ne__(self, other):
+ return not self.__eq__(other)
-class VppObjectRegistry(object):
+class VppObjectRegistry:
""" Class which handles automatic configuration cleanup. """
_shared_state = {}
- def __init__(self):
+ def __init__(self) -> None:
self.__dict__ = self._shared_state
if not hasattr(self, "_object_registry"):
self._object_registry = []
if not hasattr(self, "_object_dict"):
self._object_dict = dict()
- def register(self, o, logger):
+ def register(self, obj: VppObject, logger) -> None:
""" Register an object in the registry. """
- if not o.object_id() in self._object_dict:
- self._object_registry.append(o)
- self._object_dict[o.object_id()] = o
+ if obj.object_id() not in self._object_dict:
+ self._object_registry.append(obj)
+ self._object_dict[obj.object_id()] = obj
+ logger.debug("REG: registering %s" % obj)
else:
- logger.debug("REG: duplicate add, ignoring (%s)" % o)
+ logger.debug("REG: duplicate add, ignoring (%s)" % obj)
- def remove_vpp_config(self, logger):
+ def unregister_all(self, logger) -> None:
+ """ Remove all object registrations from registry. """
+ logger.debug("REG: removing all object registrations")
+ self._object_registry = []
+ self._object_dict = dict()
+
+ def remove_vpp_config(self, logger) -> None:
"""
Remove configuration (if present) from vpp and then remove all objects
from the registry.
return
logger.info("REG: Removing VPP configuration for registered objects")
# remove the config in reverse order as there might be dependencies
- for o in reversed(self._object_registry):
- if o.query_vpp_config():
- logger.info("REG: Removing configuration for %s" % o)
- o.remove_vpp_config()
+ failed = []
+ for obj in reversed(self._object_registry):
+ if obj.query_vpp_config():
+ logger.info("REG: Removing configuration for %s" % obj)
+ obj.remove_vpp_config()
+ if obj.query_vpp_config():
+ failed.append(obj)
else:
logger.info(
"REG: Skipping removal for %s, configuration not present" %
- o)
- failed = []
- for o in self._object_registry:
- if o.query_vpp_config():
- failed.append(o)
- self._object_registry = []
- self._object_dict = dict()
+ obj)
+ self.unregister_all(logger)
if failed:
logger.error("REG: Couldn't remove configuration for object(s):")
- for x in failed:
- logger.error(repr(x))
+ for obj in failed:
+ logger.error(repr(obj))
raise Exception("Couldn't remove configuration for object(s): %s" %
(", ".join(str(x) for x in failed)))