donutstats 0.1.1

Async client for the DonutSMP API

donutstats

Async Python wrapper for the DonutSMP API.

Install

Basic Install

pip install donutstats

Discord Feature Usage

pip install donutstats[discord]

Usage

Simple api usage

import asyncio
from donutstats import DonutStats

async def main():
    donutstats = DonutStats("Your DonutSMP api key (generate ingame with /api")

    # Full stats dict
    stats = await donutstats.get_stats(username="copa6076") # Pull the stats from donutsmp api
    print(stats.get('money')) # 2920840615

    # Single stat
    shards = await donutstats.get_shards(username="copa6076") # Pull the shards from donutsmp api
    print(shards) # 8410

    await donutstats.close() # Close it when you close your bot

asyncio.run(main())

Simple discord bot cog usage

import discord
from discord.ext import commands

from donutstats import DonutStats

class Stats(commands.Cog):
    def __init__(self, bot: commands.Bot):
        # Initialize donutstats when your cog gets initialized
        self.donutstats = DonutStats("Your DonutSMP api key (generate ingame with /api")

    @discord.app_commands.command()
    async def stats(self, interaction: discord.Interaction, username: str):
        # Returns a full stats embed
        embed: discord.Embed = await self.donutstats.get_stats_embed(username, discord.Color.blue())

        await interaction.response.send_message(embed=embed)

async def setup(bot: commands.Bot):
    await bot.add_cog(Stats(bot))

Exceptions

• DonutSMPError - Raised when DonutSMP cannot handle a query, Very likely could not find username
• UnauthorizedRequest - Raised when DonutSMP returns a 401 unauthorized.
• RateLimited - Raised when DonutSMP returns a 429 ratelimited
• UnexpectedError - Raised when there is an unexpected api response status.

License

MIT License LICENSE