Add service: DiscordListology (#9)

Author: Snazzah

README.md

@@ -122,6 +122,7 @@ See more examples [here](/examples).
  - [discordbot.world](https://discordbot.world) ([docs](https://dbots.readthedocs.io/en/latest/api.html#dbots.DiscordBotWorld))
  - [discordextremelist.xyz](https://discordextremelist.xyz) ([docs](https://dbots.readthedocs.io/en/latest/api.html#dbots.DiscordExtremeList))
  - [bots.discordlabs.org](https://bots.discordlabs.org) ([docs](https://dbots.readthedocs.io/en/latest/api.html#dbots.DiscordLabs))
+ - [discordlistology.com](https://discordlistology.com) ([docs](https://dbots.readthedocs.io/en/latest/api.html#dbots.DiscordListology))
  - [glennbotlist.xyz](https://glennbotlist.xyz) ([docs](https://dbots.readthedocs.io/en/latest/api.html#dbots.GlennBotList))
  - [lbots.org](https://lbots.org) ([docs](https://dbots.readthedocs.io/en/latest/api.html#dbots.LBots))
  - [listmybots.com](https://listmybots.com) ([docs](https://dbots.readthedocs.io/en/latest/api.html#dbots.ListMyBots))

dbots/service.py

@@ -1376,6 +1376,94 @@ def get_bot(self, bot_id: str) -> HTTPResponse:
             path = f'/bot/{bot_id}',
         )
 
+class DiscordListology(Service):
+    """
+    Represents the DiscordListology service.
+    
+    .. seealso::
+        - `DiscordListology Website <https://discordlistology.com/>`_
+        - `DiscordListology API Documentation <https://discordlistology.com/developer/documentation/>`_
+    """
+
+    BASE_URL = 'https://discordlistology.com/api/v1'
+
+    @staticmethod
+    def aliases() -> list:
+        return ['discordlistology']
+
+    @staticmethod
+    def _post(
+        http_client: HTTPClient, bot_id: str, token: str,
+        server_count = 0, user_count = 0,
+        voice_connections = 0, shard_count: int = None,
+        shard_id: int = None
+    ) -> HTTPResponse:
+        payload = { 'servers': server_count }
+        if shard_id and shard_count:
+            payload['shards'] = shard_count
+        return http_client.request(
+            method = 'POST',
+            path = f'{DiscordListology.BASE_URL}/bots/{bot_id}/stats',
+            headers = { 'Authorization': token },
+            json = payload
+        )
+
+    def get_bot_stats(self, bot_id: str) -> HTTPResponse:
+        """|httpres|\n
+        Gets the bot's stats listed on this service.
+        Parameters
+        -----------
+        bot_id: :class:`str`
+            The bot's ID.
+        """
+        return self._request(
+            method = 'GET',
+            path = f'/bots/{bot_id}/stats',
+        )
+
+    def user_voted_bot(self, bot_id: str, user_id: str) -> HTTPResponse:
+        """|httpres|\n
+        Checks whether or not a user has voted for a bot on this service.
+        Parameters
+        -----------
+        bot_id: :class:`str`
+            The bot's ID.
+        user_id: :class:`str`
+            The user's ID.
+        """
+        return self._request(
+            method = 'GET',
+            path = f'/bots/{bot_id}/hasvoted/{user_id}'
+        )
+
+    def get_guild_stats(self, guild_id: str) -> HTTPResponse:
+        """|httpres|\n
+        Gets the guild's stats listed on this service.
+        Parameters
+        -----------
+        guild_id: :class:`str`
+            The guild's ID.
+        """
+        return self._request(
+            method = 'GET',
+            path = f'/guilds/{bot_id}/stats',
+        )
+
+    def user_voted_guild(self, guild_id: str, user_id: str) -> HTTPResponse:
+        """|httpres|\n
+        Checks whether or not a user has voted for a guild on this service.
+        Parameters
+        -----------
+        guild_id: :class:`str`
+            The guild's ID.
+        user_id: :class:`str`
+            The user's ID.
+        """
+        return self._request(
+            method = 'GET',
+            path = f'/guilds/{bot_id}/hasvoted/{user_id}'
+        )
+
 class GlennBotList(Service):
     """
     Represents the Glenn Bot List service.
@@ -2132,6 +2220,6 @@ def get_unverified_bots(self) -> HTTPResponse:
 Service.SERVICES = [
     Arcane, Blist, BotListSpace, BotsDataBase, BotsForDiscord, BotsOnDiscord, Carbon,
     DBLista, DiscordBotsCo, DiscordBotsGG, DiscordAppsDev, DiscordBoats,
-    DiscordBotList, DiscordBotWorld, DiscordExtremeList, DiscordLabs, GlennBotList,
-    LBots, ListMyBots, MythicalBots, SpaceBotsList, TopGG, WonderBotList, YABL
+    DiscordBotList, DiscordBotWorld, DiscordExtremeList, DiscordLabs, DiscordListology,
+    GlennBotList, LBots, ListMyBots, MythicalBots, SpaceBotsList, TopGG, WonderBotList, YABL
 ]

docs/api.rst

@@ -94,6 +94,9 @@ Services
 .. autoclass:: DiscordLabs
     :members:
 
+.. autoclass:: DiscordListology
+    :members:
+
 .. autoclass:: GlennBotList
     :members: