diff --git a/content/docs/libraries/python.mdx b/content/docs/libraries/python.mdx index 863c196..1db3014 100644 --- a/content/docs/libraries/python.mdx +++ b/content/docs/libraries/python.mdx @@ -17,7 +17,7 @@ A simple API wrapper for [Topstats.gg](https://topstats.gg) written in Python. ## Getting started -Make sure you already have an API token handy. See [this page](https://docs.topstats.gg/authentication/tokens) on how to retrieve it. +Make sure you already have an API token handy. See [this page](https://docs.topstats.gg/docs/authentication/tokens) on how to retrieve it. After that, run the following command in your terminal: @@ -38,33 +38,45 @@ import os async def main() -> None: - + # Declare the client. async with topstats.Client(os.getenv('TOPSTATS_TOKEN')) as ts: - + # Fetch a bot from its ID. bot = await ts.get_bot(432610292342587392) - + print(bot) # Fetch topstats.gg's top bots. bots = await ts.get_top_bots(sort_by=topstats.SortBy.server_count()) - + for b in bots: print(b) + + # Search for bots that has the name 'MEE6.' + mee6_bots = await ts.search_bots(name='MEE6') + + for b in mee6_bots: + print(b) + # Search for anime-tagged bots. + anime_bots = await ts.search_bots(tag='anime') + + for b in anime_bots: + print(b) + # Fetch a bot's historical server count. sc = await ts.get_historical_bot_server_count(432610292342587392) for server_count in sc: print(server_count) - + # Compare two bots' historical server count. vs = await ts.compare_bot_server_count(432610292342587392, 437808476106784770) for first, second in vs: print(first, second) - + # Compare up to four bots' historical total vote count. vs2 = await ts.compare_bot_total_votes( topstats.Period.LAST_YEAR, @@ -78,11 +90,11 @@ async def main() -> None: print(first, second, third, fourth) if __name__ == '__main__': - + # See https://stackoverflow.com/questions/45600579/asyncio-event-loop-is-closed-when-getting-loop # for more details. if os.name == 'nt': asyncio.set_event_loop_policy(asyncio.WindowsSelectorEventLoopPolicy()) - + asyncio.run(main()) ```