Add botlistspace, fix index.rst and poster

Author: Snazzah

README.md

@@ -106,6 +106,7 @@ See more examples [here](/examples).
 ## Services
 
 ### Supported Services
+ - [botlist.space](https://botlist.space)
  - [top.gg (formerly discordbots.org)](https://top.gg)
  - [discord.bots.gg](https://discord.bots.gg)
  - *More services will be supported in a future release...*

dbots/poster.py

@@ -70,11 +70,11 @@ def __repr__(self):
     # property fill-ins
 
     @property
-    def client_id(self) -> str or None::
+    def client_id(self) -> str or None:
         return self._client_id
 
     @property
-    def shard_id(self) -> int or None::
+    def shard_id(self) -> int or None:
         return self._shard_id
 
     @property

dbots/service.py

@@ -36,6 +36,79 @@ def __repr__(self):
         ]
         return '<%s %s>' % (self.__class__.__name__, ' '.join('%s=%r' % t for t in attrs))
 
+###############################
+
+class BotListSpace(Service):
+    """
+    Represents the botlist.space's service.
+    
+    .. seealso::
+        `Service's API Documentation <https://docs.botlist.space/>`_
+            API Documentation for botlist.space
+    """
+
+    BASE_URL = 'https://api.botlist.space/v1'
+
+    @staticmethod
+    def _post(
+        http_client, bot_id, token,
+        server_count = 0, user_count = 0,
+        voice_connections = 0, shard_count = None,
+        shard_id = None
+    ):
+        return http_client.request(
+            method = 'POST',
+            path = f'{BotListSpace.BASE_URL}/bots/{bot_id}',
+            headers = { 'Authorization': token, 'Content-Type': 'application/json' },
+            json = { 'server_count': server_count }
+        )
+
+    def get_statistics(self) -> HTTPResponse:
+        return self._request(
+            method = 'GET',
+            path = '/statistics'
+        )
+
+    def get_bots(self) -> HTTPResponse:
+        return self._request(
+            method = 'GET',
+            path = '/bots'
+        )
+
+    def get_bot(self, bot_id) -> HTTPResponse:
+        return self._request(
+            method = 'GET',
+            path = f'/bots/{bot_id}'
+        )
+
+    def get_bot_votes(self, bot_id) -> HTTPResponse:
+        return self._request(
+            method = 'GET',
+            path = f'/bots/{bot_id}/upvotes',
+            requires_token = True
+        )
+
+    def get_bot_uptime(self, bot_id) -> HTTPResponse:
+        return self._request(
+            method = 'GET',
+            path = f'/bots/{bot_id}/uptime'
+        )
+
+    def get_user(self, user_id) -> HTTPResponse:
+        return self._request(
+            method = 'GET',
+            path = f'/users/{user_id}'
+        )
+
+    def get_user_bots(self, user_id) -> HTTPResponse:
+        return self._request(
+            method = 'GET',
+            path = f'/users/{user_id}/bots'
+        )
+
+    def get_widget_url(self, bot_id, style = 1, **query) -> str:
+        return f'https://api.botlist.space/widget/{bot_id}/{style}?{_encode_query(query)}'
+
 class DiscordBotsGG(Service):
     """
     Represents the discord.bots.gg service.
@@ -159,6 +232,10 @@ def get_widget_url(self, bot_id, small_widget = None, **query) -> str:
         return f'{TopGG.BASE_URL}/widget/{subpath}{bot_id}.svg?{_encode_query(query)}'
 
 Service.SERVICE_KEYMAP = {
+    'botlistspace': BotListSpace,
+    'botlist.space': BotListSpace,
+    'bls': BotListSpace,
+
     'discordbotsgg': DiscordBotsGG,
     'discord.bots.gg': DiscordBotsGG,
     'dbotsgg': DiscordBotsGG,

docs/index.rst

@@ -119,19 +119,21 @@ Services
 
 Supported Services
 ~~~~~~~~~~~~~~~~~~
+ - `botlist.space <https://botlist.space>`_
  - `top.gg <https://top.gg>`_
  - `discord.bots.gg <https://discord.bots.gg>`_
  - *More services will be supported in a future release...*
 
 Adding Custom Services
 ~~~~~~~~~~~~~~~~~~~~~~
-You can add custom services by extending from the base service class (``dbots.Service``) and overriding the ``_post`` method.  
-Make sure to add the custom service class to the service keymap. (``dbots.Service.SERVICE_KEYMAP``) An example of adding a custom service can be shown `here <https://github.com/dbots-pkg/dbots.py/blob/master/examples/custom_service.py>`_.
+You can add custom services by extending from the base service class (``dbots.Service``) and overriding the ``_post`` method.
+Make sure to add the custom service class to the service keymap. (``dbots.Service.SERVICE_KEYMAP``)
+An example of adding a custom service can be shown `here <https://github.com/dbots-pkg/dbots.py/blob/master/examples/custom_service.py>`_.
 
 Adding a custom post function
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-You can add a custom post event by defining ``on_custom_post`` in the initialization of a Poster.  
-This function can be used when executing ``poster.post('custom')`` and when all services are being posted to. 
+You can add a custom post event by defining ``on_custom_post`` in the initialization of a Poster.
+This function can be used when executing ``poster.post('custom')`` and when all services are being posted to.
 An example of adding a custom post function can be shown `here <https://github.com/dbots-pkg/dbots.py/blob/master/examples/custom_post.py>`_.
 
 Contribution