feat: add widgets

Author: null8626

docs/client.rst

@@ -4,6 +4,9 @@ Client reference
 .. autoclass:: topgg.client.Client
    :members:
 
+.. automodule:: topgg.widget
+   :members:
+
 .. autoclass:: topgg.models.SortBy()
    :members:
 

topgg/__init__.py

@@ -28,6 +28,7 @@
 from .webhooks import Vote, Webhooks
 from .version import VERSION
 from .client import Client
+from . import widget
 
 
 __title__ = 'topggpy'
@@ -49,4 +50,5 @@
   'Vote',
   'Voter',
   'Webhooks',
+  'widget',
 )

topgg/client.py

@@ -40,7 +40,7 @@
 from .version import VERSION
 
 
-BASE_URL = 'https://top.gg/api'
+BASE_URL = 'https://top.gg/api/v1'
 MAXIMUM_DELAY_THRESHOLD = 5.0
 
 

topgg/widget.py

@@ -0,0 +1,14 @@
+from .client import BASE_URL
+
+def servers(id: int) -> str:
+  """
+  Generates a large widget URL.
+
+  :param id: The requested ID.
+  :type id: :py:class:`int`
+
+  :returns: The widget URL.
+  :rtype: :py:class:`str`
+  """
+
+  return f'{BASE_URL}/widgets/large/{id}'