platypush.entities._managers -> platypush.entities.managers.

It's better for entity managers to be stored in their own public
package, instead of cluttering too much the namespace of their parent
package.

platypush/entities/__init__.py

@@ -11,17 +11,17 @@ from ._base import (
     init_entities_db,
 )
 from ._engine import EntitiesEngine
-from ._managers import (
+from .managers import (
     EntityManager,
     get_plugin_entity_registry,
     register_entity_manager,
 )
-from ._managers.lights import LightEntityManager
+from .managers.lights import LightEntityManager
-from ._managers.sensors import SensorEntityManager
+from .managers.sensors import SensorEntityManager
-from ._managers.switches import (
+from .managers.switches import (
-    SwitchEntityManager,
     DimmerEntityManager,
     EnumSwitchEntityManager,
+    SwitchEntityManager,
 )
 
 _engine: Optional[EntitiesEngine] = None

platypush/entities/managers/cloud.py

@@ -0,0 +1,41 @@
+from abc import ABC, abstractmethod
+from typing import Union
+from uuid import UUID
+
+from . import EntityManager
+
+InstanceId = Union[str, int, UUID]
+
+
+class CloudInstanceEntityManager(EntityManager, ABC):
+    """
+    Base class for integrations that support cloud instances (like Linode or
+    AWS).
+    """
+
+    @abstractmethod
+    def reboot(self, instance: InstanceId, **_):
+        """
+        Reboot an instance.
+
+        :param instance: ID or name of the instance to be rebooted.
+        """
+        raise NotImplementedError()
+
+    @abstractmethod
+    def boot(self, instance: InstanceId, **_):
+        """
+        Boot an instance.
+
+        :param instance: ID or name of the instance to be rebooted.
+        """
+        raise NotImplementedError()
+
+    @abstractmethod
+    def shutdown(self, instance: InstanceId, **_):
+        """
+        Shutdown an instance.
+
+        :param instance: ID or name of the instance to be rebooted.
+        """
+        raise NotImplementedError()