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
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