DrNoLife / QoubDiscordBot

This is a Discord bot that will call the Qoub API when summoned, and reply with a relevant coub.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

QoubDiscordBot

This is a Discord bot that will call the Qoub API when summoned, and reply with a relevant coub.

This bot is part of the larger Qoub project I have going on, which will serve as a way for myself to access my archive of Coubs, in various different ways.

Commands

The default prefix for accessing this bot is !qoub and to this, you can supply some arguments:

  • -help
    Replies with a link to this repository and section.
  • -cat <category>
    Replies with a random coub from a specific category.
  • -pop
    Replies with the most popular coub in the archive.
  • -pop <nth-popular>
    Replies with the nth-most popular coub in the archive.
  • -order <likes / views>

Some of these arguments can be mixed together, to construct more detailed queries.

Example of some commands

  • !qoub
    Returns a random coub from a random category.
  • !qoub help
    Replies with a link to this repository and section.
  • !qoub -cat <category>
    Replies with a random coub from a specific category.
  • !qoub -pop
    Replies with the most popular coub in the archive.
  • !qoub -pop <nth-popular>
    Replies with the nth-most popular coub in the archive.
  • !qoub -ord <likes / views>
    Changes the fildering mode for the popular argument.
  • !qoub -cat <category> -pop <nth-popular>
    Replies with the nth-most popular coub from a specific category.

To-do

  • Implement a way of listing all categories by using -cat with no extra argument.
  • Implement a way to search after a coub, by using -sch (this wouldn't allow any extra arguments).
  • Maybe take a took at making the code async / await, to see if it'd help out with the initial delay.

About

This is a Discord bot that will call the Qoub API when summoned, and reply with a relevant coub.


Languages

Language:Python 100.0%