donutstats

Async Python wrapper for the DonutSMP API.

Install

Requires python 3.12 or newer

Basic Install

pip install donutstats

Discord Feature Usage

pip install donutstats[discord]

Usage

Simple stats usage

import asyncio
from donutstats import DonutStats, DonutSMPError

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

    # Lookup
    lookup = await donutstats.lookup("copa6076")
    print(lookup) # {'username': 'copa6076', 'rank': 'Unknown', 'location': 'Overworld'}
    print(lookup.get('location')) # 'Overworld'

    # Unfound Player
    try:
        shards = await donutstats.get_shards(username="idontexist123d7") # Pull the shards from donutsmp api
        print(shards)
    except DonutSMPError:
        # This code runs when the player is not found
        print("Could not find player")

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

asyncio.run(main())

Functions

Exceptions

• DonutSMPError - Raised when DonutSMP cannot handle a query - Likely cannot find player/page/item
• 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

Released under the MIT License. See LICENSE.