This project is now retired
I do not work on discord bots anymore, and consequently do not use top.gg anymore.
This package should continue to work with v0 of the top.gg API, however will not work with v1 or any newer versions, assuming they are breaking changes to the API.
You are welcome to fork and continue developing this code should you wish, however, for a project that is guaranteed to continue being developed well into the future, I recommend you use the official python SDK..
I am, however, now creating bots on matrix, and even have my own bot library!
This repository is indefinitely archived.
Top.py
An alternative wrapper for the top.gg API
Please note, this is not an official package from top.gg. We are not affiliated with top.gg in any way. If you want to install their official package, please see their repo.
Introduction
Warning! top.py is not tested to be compatible with discord.py forks, or any other library than the official discord.py library. If you encounter issues when using another library, please open an issue with as much detail and support will be added.
top.py is a python wrapper for the top.gg discord bot list API. top.py aims to be object-oriented, whereas the official top.gg python SDK is more low-level raw data.
Installation
You can install the latest stable release here:
pip install top.py
But, if you're reading this, you're most likely a developer - you should know how to install packages by now.
Examples
You can see examples in the examples.md file.
Supported Features
| Feature Name | Supported? |
|---|---|
| Automatic posting of server count | ✅ |
| Searching/Bulk Querying Bots | ✅ |
| Fetching a bot | ✅ |
| Fetching a user | ✅ |
| Fetching last 1000 upvotes | ✅ |
| Fetching a bot's stats | ✅ |
| Checking individual user vote | ✅ |
| Manual posting server count | ✅ |
| Models for all individual endpoints | ✅ |
| In-house ratelimiting | ✅ |
| Vote Webhooks | ✅ |
| Making you a nice slice of toast | ❌ |
NOTE: We do NOT currently provide official support for discord server list. That's coming soon.
top.py features
- Object-Oriented (No-more shall you faff about with dictionaries)
- Sensible function names & arguments
Useful links
support (or mention @eek#7574 in top.gg) | docs | PyPi | examples | (META) Code Of Conduct | (META) Contributing Guidelines
1 maintainer
Metadata
1 maintainer
Release files for top.py 1.4.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| top.py-1.4.3.tar.gz | 31.2 kB | Without provenance | Details for top.py-1.4.3.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| top.py-1.4.3-py3-none-any.whl | Python 3 | none | any | Details for top.py-1.4.3-py3-none-any.whl |
Total release size: 63.6 kB
Release files / top.py-1.4.3.tar.gz
| Download URL | top.py-1.4.3.tar.gz |
|---|---|
| Size | 31.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
653e59bd57810909b907a041df7880fe22763c3c2057e9a83a50e31284c49566
|
|
BLAKE2b-256 checksum How to use checksums |
0c3d1dd7e7b0aec8a958f51cd114970d5be56b597ea45fe5b3c4276417536b1e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.2 CPython/3.10.13
|
Release files / top.py-1.4.3-py3-none-any.whl
| Download URL | top.py-1.4.3-py3-none-any.whl |
|---|---|
| Size | 32.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
8c3e6d1552abde100391e905a117aca7fd6b2e6f61965f94e32fdc90f9c2b92d
|
|
BLAKE2b-256 checksum How to use checksums |
8bc2a29bde0bcfa28b67c175b589e2a8e866c8b69d95dcfff6e7b89d839bf253
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.2 CPython/3.10.13
|
Security for top.py 1.4.3
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
