[V3 Utils] Menu system

[palmtree5]

Type

• Bugfix
• Enhancement
• New feature

Description of the changes

This is a possible implementation for a menu system. Basically, cog devs can pass in context, a list of either strings or embeds and a dict mapping of emoji to functions and the user will get a menu controlled by emoji. An example:

from redbot.core.utils.menus import menu, DEFAULT_CONTROLS
import discord

class MyCog:
    @commands.command()
    async def mycom(self, ctx):
        pages = [discord.Embed(title="blah"), discord.Embed(title="blah 2")]
        await menu(ctx, pages, DEFAULT_CONTROLS)

will yield a menu where users can change pages and close the menu

DEFAULT_CONTROLS is basically a quick way to use the menu system if cog devs are fine using some default functions to handle menu controls (basically, these are a function to move to the next page, a function to move to the previous page, and a function to close the menu (deleting the message that is the menu))

[bobloy]

Uses next_page as variable and next_page and function

[bobloy]

It appears multiple instances of a menu will trigger each other's button presses.
i.e ❌ will close all menus

[Bakersbakebread]

Upvote

[bobloy]

add and r.message==message

[bobloy]

Swap order of next_page and prev_page for clearer buttons