Added support for custom user events

docs/source/events.rst

@@ -16,6 +16,7 @@ Events
     platypush/events/chat.telegram.rst
     platypush/events/clipboard.rst
     platypush/events/covid19.rst
+    platypush/events/custom.rst
     platypush/events/distance.rst
     platypush/events/foursquare.rst
     platypush/events/geo.rst

docs/source/platypush/events/custom.rst

@@ -0,0 +1,5 @@
+``platypush.message.event.custom``
+==================================
+
+.. automodule:: platypush.message.event.custom
+    :members:

platypush/message/event/custom.py

@@ -0,0 +1,18 @@
+from platypush import Event
+
+
+class CustomEvent(Event):
+    """
+    This type can be used to fire custom events upon which the user can implement custom hooks.
+    """
+    def __init__(self, subtype: str, *args, **kwargs):
+        """
+        :param subtype: This is the only mandatory attribute for this event type. It should be a string that
+            unambiguously identifies a certain type of event (like ``DISHWASHER_STARTED`` or ``SMOKE_DETECTED``).
+        :param args: Extra list arguments for the event.
+        :param kwargs: Extra key-value arguments for the event.
+        """
+        super().__init__(*args, subtype=subtype, **kwargs)
+
+
+# vim:sw=4:ts=4:et: