README.md

DSlash

THIS PROJECT IS NO LONGER MAINTAINED

Danny has returned from a break, and Discord.py is now being maintained again, with support for slash commands. Nextcord also now has built-in support for slash commands. For new projects, you should use one of these options (or another).

Dslash will continue to receive minimal updates to keep it working, at least for the near future, but it will not receive support for new features.

One change Discord has made since this library stopped being maintained was to remove support for bots configuring permissions for their own commands. In order to avoid breaking bots, Dslash still allows permissions to be configured as before, but will now ignore them. The allow_roles, allow_users, disallow_roles, disallow_users, global_permissions and guild_permissions wrappers, as well as the default_permission and permissions parameters are all deprecated and should not be used.

A library which supplements Nextcord (a fork of Discord.py) by adding support for slash commands.

Documentation is still a work in progress, and the library should currently be considered unstable.

You can install it using pip, eg. pip install dslash.

Example

import logging
import random
import typing

from dslash import Choices, CommandClient, CommandGroup, CommandSubGroup, subcommand
from nextcord import Embed, Interaction, Member, Role, Attachment

GUILD_ID = ...
TOKEN = ...

logging.basicConfig(level=logging.INFO)
client = CommandClient(guild_id=GUILD_ID)


@client.event
async def on_ready():
    print(f"Logged in as {client.user}.")


@client.command()
async def roll(interaction: Interaction, sides: typing.Optional[int]):
    """Roll a dice.

    :param sides: How many sides (default 6).
    """
    value = random.randint(1, sides or 6)
    await interaction.response.send_message(f"You got: {value}")


@client.group
class Images(CommandGroup):
    """Cute image commands."""

    @subcommand()
    async def cat(self, interaction: Interaction):
        """Get a cat image."""
        await interaction.response.send_message(
            embed=Embed().set_image(url="https://cataas.com/cat")
        )

    @subcommand()
    async def dog(self, interaction: Interaction):
        """Get a dog image."""
        await interaction.response.send_message(
            embed=Embed().set_image(url="https://placedog.net/500?random")
        )

    @subcommand(name="any")
    async def any_(self, interaction: Interaction):
        """Get any random image."""
        await interaction.response.send_message(
            embed=Embed().set_image(url="https://picsum.photos/600")
        )

    @subcommand()
    async def upload(self, interaction: Interaction, image: Attachment):
        """Upload a new cute image."""
        print(f"Uploading {image.proxy_url!r}...")
        await interaction.response.send_message("All done!")


@client.group
class Admin(CommandGroup):
    """Admin-only commands."""

    class Roles(CommandSubGroup):
        """Commands to manage roles."""

        @subcommand(name="del")
        async def del_(self, interaction: Interaction, role: Role):
            """Delete a role.

            :param role: The role to delete.
            """
            await role.delete()
            await interaction.response.send_message("Deleted the role.", ephemeral=True)


@client.command()
async def ban(interaction: Interaction, user: Member):
    """Ban a user.

    :param user: The user to ban.
    """
    await user.ban()
    await interaction.response.send_message("Banned the user.", ephemeral=True)


class RPSChoices(Choices):
    rock = "Rock"
    paper = "Paper"
    scissors = "Scissors"
    gun = "Gun"


@client.command()
async def rps(interaction: Interaction, choice: RPSChoices):
    """Play rock, paper, scissors.

    :param choice: Your choice.
    """
    if choice == RPSChoices.gun:
        await interaction.response.send_message("That's cheating!")
    else:
        await interaction.response.send_message(f"You picked {choice.name}.")


client.run(TOKEN)

Development

As well as Python 3.9+, this project requires Poetry for development. Click this link for installation instructions, or:

• *nix (Linux/MacOS)

  curl -sSL https://raw.githubusercontent.com/python-poetry/poetry/master/install-poetry.py | python -

• Windows Powershell

  (Invoke-WebRequest -Uri https://raw.githubusercontent.com/python-poetry/poetry/master/install-poetry.py -UseBasicParsing).Content | python -

Once you have Poetry installed:

1. Create a virtual environment: poetry shell
2. Install dependencies: poetry install

The following commands are then available:

• poe format - Run auto-formatting and linting.

Prefix these with poetry run if outside of the Poetry shell.