dbots 1.2.2

Discord bot list poster and stats retriever

A stats poster and API wrapper for all botlists.

Table of Contents

• About
• Installing
• Examples
  • Example with client
  • Example without client
• Services
  • Supported Services
  • Adding Custom Services
  • Adding a custom post function
• Contribution
• Other Links

About

dbots helps Discord bot developers group all your statistic posting needs into one poster, complete with seperate posting, and a loop to post to all services every n seconds.

Installing

Python 3.6 or higher is required! You can install dbots by running this command:

# Linux/macOS
python3 -m pip install -U dbots

# Windows
py -3 -m pip install -U dbots

To install package from the master branch, do the following:

git clone https://github.com/dbots-pkg/dbots.py
cd dbots.py
python3 -m pip install -U

Examples

Example with client

Currently, only discord.py is supported as a usable client. (You can use any derivative of discord.py as long as it does not interfere with important properties used by dbots.)

import discord
import dbots

client = discord.Client()
poster = dbots.ClientPoster(client, 'discord.py', api_keys = {
    'top.gg': '…',
    'discord.bots.gg': '…'
})

@client.event
async def on_ready():
    print('Logged on as', client.user)
    await poster.post()
    # This posts to all lists every 30 minutes
    # You can stop the loop with `poster.kill_loop()`
    poster.start_loop()

@poster.event
async def on_auto_post(response):
    print('Auto-Post:', response)

"""
You can also define the event you want to get by adding an argument to the decorator.

@poster.event('post')
async def some_function(response):
    print(response)
"""

Example without client

import dbots

client_id = '1234567890'
def server_count():
  return 100
def user_count():
  return 100
def voice_connections():
  return 0

# `server_count`, `user_count`, and `voice_connections` can either be regular functions or coroutines
poster = dbots.Poster(client_id, server_count, user_count, voice_connections, api_keys = {
    'top.gg': '…',
    'discord.bots.gg': '…'
})

See more examples here.

Services

Supported Services

• arcane-center.xyz (docs)
• botlist.space (docs)
• botsfordiscord.com (docs)
• b-o-d.cf (docs)
• bots.ondiscord.xyz (docs)
• carbonitex.net (docs)
• cloud-botlist.xyz (docs)
• *cloudlist.xyz (docs)
• dblista.pl (docs)
• discord.bots.gg (docs)
• discordapps.dev (docs)
• discord.boats (docs)
• discordbotlist.com (docs)
• discordbot.world (docs)
• discordextremelist.xyz (docs)
• *divinediscordbots.com (docs)
• glennbotlist.xyz (docs)
• lbots.org (docs)
• listmybots.com (docs)
• mythicalbots.xyz (docs)
• space-bot-list.org (docs)
• top.gg (docs)
• wonderbotlist.com (docs)
• yabl.xyz (docs)

*These services (cloudlist & divinediscordbots) are shutting down. Any service objects and functions towards these services will be removed in the next major release.

Adding Custom Services

You can add custom services by extending from the base service class (dbots.Service) and overriding the _post and aliases method.
Make sure to add the custom service class to the service keymap. (dbots.Service.SERVICE_KEYMAP) An example of adding a custom service can be shown here.

Adding a custom post function

You can add a custom post event by defining on_custom_post in the initialization of a Poster.
This function can be used when executing poster.post('custom') and when all services are being posted to. An example of adding a custom post function can be shown here.

Contribution

Any contribution may be useful for the package! Make sure when making issues or PRs that the issue has not been addressed yet in a past issue/PR.

Other Links

• PyPi
• Libraries.io
• Documentation
• dbots Github Organization