Skip to content

Files

Latest commit

 Cannot retrieve latest commit at this time.

History

History
151 lines (107 loc) · 3.81 KB

framework_utils.rst

File metadata and controls

151 lines (107 loc) · 3.81 KB

Utility Functions

General Utility

.. automodule:: redbot.core.utils
    :members: deduplicate_iterables, bounded_gather, bounded_gather_iter, get_end_user_data_statement, get_end_user_data_statement_or_raise, can_user_send_messages_in, can_user_manage_channel, can_user_react_in

.. autoclass:: AsyncIter
    :members:
    :special-members: __await__
    :exclude-members: enumerate, filter

    .. automethod:: enumerate
        :async-for:

    .. automethod:: filter
        :async-for:


Chat Formatting

.. automodule:: redbot.core.utils.chat_formatting
    :members:
    :exclude-members: pagify

    .. autofunction:: pagify(text, delims=('\n',), *, priority=False, escape_mass_mentions=True, shorten_by=8, page_length=2000)
        :for:

Embed Helpers

.. automodule:: redbot.core.utils.embed
    :members:
    :exclude-members: randomize_color

Menus

.. automodule:: redbot.core.utils.menus
    :members:

Event Predicates

MessagePredicate

.. autoclass:: redbot.core.utils.predicates.MessagePredicate
    :members:

ReactionPredicate

.. autoclass:: redbot.core.utils.predicates.ReactionPredicate
    :members:

Mod Helpers

.. automodule:: redbot.core.utils.mod
    :members:

Tunnel

.. automodule:: redbot.core.utils.tunnel
    :members: Tunnel
    :exclude-members: files_from_attatch

Common Filters

.. automodule:: redbot.core.utils.common_filters
    :members:

Utility UI

.. automodule:: redbot.core.utils.views
    :members:
    :exclude-members: ConfirmView

    .. autoclass:: ConfirmView
        :members:
        :exclude-members: confirm_button, dismiss_button

        .. autoattribute:: confirm_button
            :no-value:

            A `discord.ui.Button` to confirm the message.

            The button's callback will set `result` to ``True``, defer the response,
            and call `on_timeout()` to clean up the view.

            .. rubric:: Example

            Changing the style and label of this `discord.ui.Button`::

                view = ConfirmView(ctx.author)
                view.confirm_button.style = discord.ButtonStyle.red
                view.confirm_button.label = "Delete"
                view.dismiss_button.label = "Cancel"
                view.message = await ctx.send(
                    "Are you sure you want to remove #very-important-channel?", view=view
                )
                await view.wait()
                if view.result:
                    await ctx.send("Channel #very-important-channel deleted.")
                else:
                    await ctx.send("Canceled.")

            :type: discord.ui.Button

        .. autoattribute:: dismiss_button
            :no-value:

            A `discord.ui.Button` to dismiss the message.

            The button's callback will set `result` to ``False``, defer the response,
            and call `on_timeout()` to clean up the view.

            .. rubric:: Example

            Changing the style and label of this `discord.ui.Button`::

                view = ConfirmView(ctx.author)
                view.confirm_button.style = discord.ButtonStyle.red
                view.confirm_button.label = "Delete"
                view.dismiss_button.label = "Cancel"
                view.message = await ctx.send(
                    "Are you sure you want to remove #very-important-channel?", view=view
                )
                await view.wait()
                if view.result:
                    await ctx.send("Channel #very-important-channel deleted.")
                else:
                    await ctx.send("Canceled.")

            :type: discord.ui.Button

AntiSpam

.. automodule:: redbot.core.utils.antispam
    :members: