fix: add Python 3.12 support

.gitattributes

@@ -0,0 +1 @@
+* eol=lf

.github/workflows/release.yml

@@ -0,0 +1,21 @@
+name: Publish
+on:
+  release:
+    types: [created]
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: 3.13
+      - name: Install dependencies
+        run: python3 -m pip install build twine
+      - name: Build and publish
+        env:
+          TWINE_USERNAME: __token__
+          TWINE_PASSWORD: ${{ secrets.PYPI_TOKEN }}
+        run: |
+          python3 -m build
+          python3 -m twine upload dist/*

.github/workflows/test.yml

@@ -0,0 +1,32 @@
+name: Run tests
+on:
+  push:
+    branches: [master]
+    paths:
+      - '.github/workflows/test.yml'
+      - 'topgg/**/*.py'
+  pull_request:
+    paths:
+      - '.github/workflows/test.yml'
+      - 'topgg/**/*.py'
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: [3.9, '3.10', 3.11, 3.12, 3.13]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install dependencies
+        run: python3 -m pip install . -r requirements-dev.txt
+      - name: Run tests
+        run: python3 -m pytest
+      - name: Install ruff
+        if: ${{ matrix.python-version == 3.13 }}
+        run: python3 -m pip install ruff
+      - name: Lint with ruff
+        if: ${{ matrix.python-version == 3.13 }}
+        run: python3 -m ruff check

.gitignore

@@ -1,11 +1,10 @@
-dblpy.egg-info/
 topggpy.egg-info/
-topgg/__pycache__/
 build/
 dist/
-/docs/_build
-/docs/_templates
-.vscode
-/.idea/
-__pycache__
+docs/_build
+docs/_templates
+.vscode/
+.idea/
+**/__pycache__/
 .coverage
+.ruff_cache/

.readthedocs.yml

@@ -1,13 +1,11 @@
 version: 2
-
-sphinx:
-   configuration: docs/conf.py
-
 build:
-   image: latest
-
+  os: ubuntu-24.04
+  tools:
+    python: '3.13'
+sphinx:
+  configuration: docs/conf.py
 python:
-  version: 3.8
   install:
-    - requirements: requirements.txt
-    - requirements: requirements-docs.txt
+  - requirements: requirements.txt
+  - requirements: requirements-docs.txt

LICENSE

@@ -1,4 +1,5 @@
 Copyright 2021 Assanali Mukhanov & Top.gg
+Copyright 2024-2025 null8626 & Top.gg
 
 Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
 

MANIFEST.in

@@ -1,3 +1,16 @@
-include LICENSE
-include requirements.txt
-include README.rst
+prune .github
+prune .ruff_cache
+prune docs
+prune examples
+prune tests
+exclude .gitattributes
+exclude .gitignore
+exclude .readthedocs.yml
+exclude mypy.ini
+exclude pytest.ini
+exclude requirements.txt
+exclude requirements-dev.txt
+exclude requirements-docs.txt
+exclude ruff.toml
+exclude ISSUE_TEMPLATE.md
+exclude PULL_REQUEST_TEMPLATE.md

README.rst

@@ -4,42 +4,30 @@ Top.gg Python Library
 
 .. image:: https://img.shields.io/pypi/v/topggpy.svg
    :target: https://pypi.python.org/pypi/topggpy
-   :alt: View on PyPi
-.. image:: https://img.shields.io/pypi/pyversions/topggpy.svg
-   :target: https://pypi.python.org/pypi/topggpy
-   :alt: v1.0.0
-.. image:: https://readthedocs.org/projects/topggpy/badge/?version=latest
+   :alt: View on PyPI
+.. image:: https://img.shields.io/pypi/dm/topggpy?style=flat-square
    :target: https://topggpy.readthedocs.io/en/latest/?badge=latest
-   :alt: Documentation Status
+   :alt: Monthly PyPI downloads
 
-A simple API wrapper for `Top.gg <https://top.gg/>`_ written in Python, supporting discord.py.
+A simple API wrapper for `Top.gg <https://top.gg/>`_ written in Python.
 
 Installation
 ------------
 
-Install via pip (recommended)
-
-.. code:: bash
-
-    pip3 install topggpy
-
-Install from source
-
 .. code:: bash
 
-    pip3 install git+https://github.com/top-gg/python-sdk/
+    pip install topggpy
 
 Documentation
 -------------
 
-Documentation can be found `here <https://topggpy.rtfd.io>`_
+Documentation can be found `here <https://topggpy.readthedocs.io/en/latest/>`_
 
 Features
 --------
 
 * POST server count
 * GET bot info, server count, upvote info
-* GET all bots
 * GET user info
 * GET widgets (large and small) including custom ones. See `docs.top.gg <https://docs.top.gg/>`_ for more info.
 * GET weekend status

docs/_static/script.js

@@ -0,0 +1,20 @@
+document.addEventListener('load', () => {
+  try {
+    document.querySelector('.edit-this-page').remove()
+
+    // remove these useless crap that appears on official readthedocs builds
+    document.querySelector('#furo-readthedocs-versions').remove()
+    document.querySelector('.injected').remove()
+  } catch {
+    // we're building this locally, forget it
+  }
+})
+
+for (const label of document.querySelectorAll('.sidebar-container label')) {
+  const link = [...label.parentElement.children].find(child => child.nodeName === 'A')
+
+  link.addEventListener('click', event => {
+    event.preventDefault()
+    label.click()
+  })
+}

docs/_static/style.css

@@ -0,0 +1,48 @@
+body {
+  --color-link-underline: rgba(0, 0, 0, 0);
+  --color-link-underline--hover: var(--color-link);
+  --color-inline-code-background: rgba(0, 0, 0, 0);
+  --color-api-background-hover: var(--color-background-primary);
+  --color-highlight-on-target: var(--color-background-primary) !important;
+
+  --font-stack: "Inter", sans-serif !important;
+  --font-stack--monospace: "Roboto Mono", monospace !important;
+}
+
+aside.toc-drawer {
+  visibility: hidden;
+}
+
+#furo-readthedocs-versions, .injected, .edit-this-page, .related-pages, .headerlink {
+  visibility: hidden;
+  user-select: none;
+}
+
+dd dt {
+  color: var(--color-foreground-secondary);
+}
+
+aside.toc-drawer .docutils:hover, .sidebar-brand-text:hover {
+  transition: 0.15s;
+  filter: opacity(75%);
+}
+
+.highlight .c1, em {
+  font-style: normal !important;
+}
+
+.highlight .nn {
+  text-decoration: none !important;
+}
+
+h1 {
+  font-weight: 900;
+}
+
+.sidebar-brand-text {
+  font-weight: bolder;
+}
+
+.sidebar-scroll .reference.internal {
+  color: var(--color-brand-primary);
+}

docs/api/autopost.rst

@@ -1,6 +1,6 @@
-#######################
-Auto-post API Reference
-#######################
+##################
+Autopost reference
+##################
 
 .. automodule:: topgg.autopost
     :members:

docs/api/client.rst

@@ -1,6 +1,6 @@
-####################
-Client API Reference
-####################
+################
+Client reference
+################
 
 .. automodule:: topgg.client
     :members:

docs/api/data.rst

@@ -1,6 +1,6 @@
-##################
-Data API Reference
-##################
+##############
+Data reference
+##############
 
 .. automodule:: topgg.data
     :members: