Implement auto moderation

changes/1220.feature.md

@@ -0,0 +1 @@
+Add support for the auto-moderation API.

hikari/__init__.py

@@ -69,6 +69,7 @@
 from hikari.applications import TeamMembershipState
 from hikari.applications import TokenType
 from hikari.audit_logs import *
+from hikari.auto_mod import *
 from hikari.channels import *
 from hikari.colors import *
 from hikari.colours import *

hikari/__init__.pyi

@@ -47,6 +47,7 @@ from hikari.applications import TeamMember as TeamMember
 from hikari.applications import TeamMembershipState as TeamMembershipState
 from hikari.applications import TokenType as TokenType
 from hikari.audit_logs import *
+from hikari.auto_mod import *
 from hikari.channels import *
 from hikari.colors import *
 from hikari.colours import *

hikari/api/entity_factory.py

@@ -33,6 +33,7 @@
 if typing.TYPE_CHECKING:
     from hikari import applications as application_models
     from hikari import audit_logs as audit_log_models
+    from hikari import auto_mod as auto_mod_models
     from hikari import channels as channel_models
     from hikari import commands
     from hikari import embeds as embed_models
@@ -1997,3 +1998,52 @@ def deserialize_webhook(self, payload: data_binding.JSONObject) -> webhook_model
         hikari.errors.UnrecognisedEntityError
             If the channel type is unknown.
         """
+
+    ###################
+    # AUTO-MOD MODELS #
+    ###################
+
+    @abc.abstractmethod
+    def deserialize_auto_mod_action(self, payload: data_binding.JSONObject) -> auto_mod_models.PartialAutoModAction:
+        """Parse a raw payload from Discord into an auto-moderation action object.
+
+        Parameters
+        ----------
+        payload : hikari.internal.data_binding.JSONObject
+            The JSON payload to deserialize.
+
+        Returns
+        -------
+        hikari.auto_mod.PartialAutoModAction
+            The deserialized auto-moderation action object.
+        """
+
+    @abc.abstractmethod
+    def serialize_auto_mod_action(self, action: auto_mod_models.PartialAutoModAction) -> data_binding.JSONObject:
+        """Serialize an auto-moderation action object to a json serializable dict.
+
+        Parameters
+        ----------
+        overwrite : hikari.auto_mod.PartialAutoModAction
+            The auto-moderation action object to serialize.
+
+        Returns
+        -------
+        hikari.internal.data_binding.JSONObject
+            The serialized representation of the auto-moderation action object.
+        """
+
+    @abc.abstractmethod
+    def deserialize_auto_mod_rule(self, payload: data_binding.JSONObject) -> auto_mod_models.AutoModRule:
+        """Parse a raw payload from Discord into an auto-moderation rule object.
+
+        Parameters
+        ----------
+        payload : hikari.internal.data_binding.JSONObject
+            The JSON payload to deserialize.
+
+        Returns
+        -------
+        hikari.auto_mod.AutoModRule
+            The deserialized auto-moderation rule object.
+        """

hikari/api/event_factory.py

@@ -42,6 +42,7 @@
     from hikari import voices as voices_models
     from hikari.api import shard as gateway_shard
     from hikari.events import application_events
+    from hikari.events import auto_mod_events
     from hikari.events import channel_events
     from hikari.events import guild_events
     from hikari.events import interaction_events
@@ -1410,3 +1411,79 @@ def deserialize_voice_server_update_event(
         hikari.events.voice_events.VoiceServerUpdateEvent
             The parsed voice server update event object.
         """
+
+    @abc.abstractmethod
+    def deserialize_auto_mod_rule_create_event(
+        self, shard: gateway_shard.GatewayShard, payload: data_binding.JSONObject
+    ) -> auto_mod_events.AutoModRuleCreateEvent:
+        """Parse a raw payload from Discord into an auto-mod rule create event object.
+
+        Parameters
+        ----------
+        shard : hikari.api.shard.GatewayShard
+            The shard that emitted this event.
+        payload : hikari.internal.data_binding.JSONObject
+            The dict payload to parse.
+
+        Returns
+        -------
+        hikari.events.voice_events.AutoModRuleCreateEvent
+            The parsed auto-mod rule create event object.
+        """
+
+    @abc.abstractmethod
+    def deserialize_auto_mod_rule_update_event(
+        self, shard: gateway_shard.GatewayShard, payload: data_binding.JSONObject
+    ) -> auto_mod_events.AutoModRuleUpdateEvent:
+        """Parse a raw payload from Discord into an auto-mod rule update event object.
+
+        Parameters
+        ----------
+        shard : hikari.api.shard.GatewayShard
+            The shard that emitted this event.
+        payload : hikari.internal.data_binding.JSONObject
+            The dict payload to parse.
+
+        Returns
+        -------
+        hikari.events.voice_events.AutoModRuleUpdateEvent
+            The parsed auto-mod rule update event object.
+        """
+
+    @abc.abstractmethod
+    def deserialize_auto_mod_rule_delete_event(
+        self, shard: gateway_shard.GatewayShard, payload: data_binding.JSONObject
+    ) -> auto_mod_events.AutoModRuleDeleteEvent:
+        """Parse a raw payload from Discord into an auto-mod rule delete event object.
+
+        Parameters
+        ----------
+        shard : hikari.api.shard.GatewayShard
+            The shard that emitted this event.
+        payload : hikari.internal.data_binding.JSONObject
+            The dict payload to parse.
+
+        Returns
+        -------
+        hikari.events.voice_events.AutoModRuleDeleteEvent
+            The parsed auto-mod rule delete event object.
+        """
+
+    @abc.abstractmethod
+    def deserialize_auto_mod_action_execution_event(
+        self, shard: gateway_shard.GatewayShard, payload: data_binding.JSONObject
+    ) -> auto_mod_events.AutoModActionExecutionEvent:
+        """Parse a raw payload from Discord into an auto-mod action  execution event object.
+
+        Parameters
+        ----------
+        shard : hikari.api.shard.GatewayShard
+            The shard that emitted this event.
+        payload : hikari.internal.data_binding.JSONObject
+            The dict payload to parse.
+
+        Returns
+        -------
+        hikari.events.voice_events.AutoModActionExecutionEvent
+            The parsed auto-mod action execution event object.
+        """