What’s New

This page keeps a detailed human friendly rendering of what’s new and changed in specific versions.

v1.4.0

• The type of data passed to on_dbl_vote has been changed from dict to BotVoteData

• The type of data passed to on_dsl_vote has been changed from dict to ServerVoteData

v1.3.0

• Introduced global ratelimiter to follow Top.gg global ratelimits

  • Fixed an AttributeError raised by HTTPClient.request()

  • Resource-specific ratelimit is now actually resource-specific

v1.2.0

• Introduced global ratelimiter along with bot endpoints ratelimiter

• Follow consistency with typing in HTTPClient and DBLClient along with updated docstrings (GH-55)

v1.1.0

• Introduced data models

  • DBLClient.get_bot_votes() now returns a list of BriefUserData objects

  • DBLClient.get_bot_info() now returns a BotData object

  • DBLClient.get_guild_count() now returns a BotStatsData object

  • DBLClient.get_user_info() now returns a UserData object

• WebhookManager.run() now returns an asyncio.Task, meaning it can now be optionally awaited

v1.0.1

• WebhookManager.webserver now instead returns aiohttp.web.Application for ease of use

v1.0.0

• Renamed the module folder from dbl to topgg

• Added post_shard_count argument to DBLClient.post_guild_count()

• Autopost now supports automatic shard posting (GH-42)

• Large webhook system rework, read the Webhooks section for more

  • Added support for server webhooks

• Renamed DBLException to TopGGException

• Renamed DBLClient.get_bot_upvotes() to DBLClient.get_bot_votes()

• Added DBLClient.generate_widget() along with the widgets section in the documentation

• Implemented a properly working ratelimiter

• Added on_autopost_error()

• All autopost events now follow on_autopost_x naming format, e.g. on_autopost_error(), on_autopost_success()

• Added handlers for autopost args set when autopost is disabled

v0.4.0

• DBLClient.post_guild_count() now supports a custom guild_count argument, which accepts either an integer or list of integers

• Reworked how shard info is posted

• Removed InvalidArgument and ConnectionClosed exceptions

• Added ServerError exception

v0.3.3

• Internal changes regarding support of Top.gg migration

• Fixed errors raised when using DBLClient.close() without built-in webhook

v0.3.2

• Client class has been renamed to DBLClient

v0.3.1

• Added on_guild_post, an event that is called when autoposter successfully posts guild count

• Renamed get_upvote_info to get_bot_upvotes

• Added get_user_vote

v0.3.0

• DBLClient now has autopost kwarg that will post server count automatically every 30 minutes

• Fixed code 403 errors

• Added on_dbl_vote, an event that is called when you test your webhook

• Added on_dbl_test, an event that is called when someone tests your webhook

v0.2.1

• Added webhook

• Removed support for discord.py versions lower than 1.0.0

• Made DBLClient.get_weekend_status() return a boolean value

• Added webhook example in README

• Removed post_server_count and get_server_count

v0.2.0

• Added post_guild_count

  • Made post_server_count an alias for post_guild_count

  • Added get_guild_count

• Made get_server_count an alias for get_guild_count

• Added DBLClient.get_weekend_status()

• Removed all parameters from DBLClient.get_upvote_info()

• Added limit to DBLClient.get_bots()

• Fixed example in README

v0.1.6

• Bug fixes & improvements

v0.1.4

• Initial ratelimit handling

v0.1.3

• Added documentation

• Fixed some minor bugs

v0.1.2

Initial release

• Working

  • POSTing server count

  • GET bot info, server count, upvote count, upvote info

  • GET all bots

  • GET specific user info

  • GET widgets (large and small) including custom ones. See Top.gg docs for more info.

• Not Working / Implemented

  • Searching for bots via the api