#discord #bots #discord-bot #topgg #dbl #discordbotslist

topgg-rs

A top.gg library that makes posting and getting info easy!

4 releases (2 breaking)

0.3.0 Feb 1, 2021
0.2.1 Jan 24, 2021
0.2.0 Jan 24, 2021
0.1.0 Jan 23, 2021

#435 in HTTP client

MIT license

19KB
381 lines

topgg-rs

A rust wrapper for the top.gg API that abides by their rate limit and even has webhook support.

How to use

In your cargo.toml please put

[dependencies]
topgg-rs = "0.3.0"

Standard usage

#[tokio::main]
async fn main() {
    c = topgg::Topgg::new(bot_id, topgg_token);
    
    // gets the top.gg info about your bot
    c.my_bot().await.unwrap();
    // gets the top.gg info about another bot
    c.bot(another_bot_id).await.unwrap();
    
    // gets info about a user
    c.user(a_user_id).await.unwrap();
    
    // gets the IDs of the people who have voted for your bot (the id you initialised with)
    c.my_votes().await.unrwap();
    // gets the IDs of the people who have voted for any bot
    c.votes(another_bot_id).await.unrwap();
    
    // checks if a user has voted for the bot you initalised with
    c.voted_for_me(user_id).await.unwrap();
    // checks if a user has voted for the bot
    c.voted(another_bot_id, user_id).await.unwrap();
    
    // gets stats about the server count, servers per shard, and shard count
    c.get_bot_stats(another_bot_id).await.unwrap();
    c.my_bot_stats().await.unwrap(); // or your bot
    
    // simply posts the server count to top.gg 
    c.post_bot_stats(Some(server_count), None, None, None).await;
    // It can also post more complex data like the servers per shard, shard_id of the server count, and shard count
    c.post_bot_stats(None, Some(shards), None, None).await;
    c.post_bot_stats(Some(server_count), None, Some(shard_id_that_posted), None).await;
    c.post_bot_stats(Some(server_count), None, None, Some(shard_count)).await;
}

Webhook support

If you want to use webhooks with this then here is an example

use futures::StreamExt;

#[tokio::main]
async fn main() {
    let mut events = topgg::WebhookClient::start(3030, "a-very-secret-password".to_string());

    while let Some(msg) = events.next().await {
        println!("{:?}", msg)
    }
}

Dependencies

~11–23MB
~369K SLoC