dslash 0.1.0

A library which supplements Discord.py by adding support for slash commands.

DSlash

A library which supplements Discord.py by adding support for slash commands.

Unlike other libraries, this uses Discord.py's new support for Interactions, which means it works easily with Discord.py's Buttons and Selects.

Documentation is still a work in progress, and the library should currently be considered unstable. It will remain so at least until Discord.py v2 is released and stable.

You can install it using pip, eg. pip install dslash. Currently, because Discord.py v2 has not been published to PyPI, you will have to install it separately: pip install git+https://github.com/Rapptz/discord.py.

Example

import random
import logging
import traceback

from discord import Embed, Interaction, Member, Role
from dslash import CommandClient, SlashCommandInvokeError, allow_roles, option


GUILD_ID = ...
ADMIN_ROLE_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: int = option('How many sides (default 6).')):
    """Roll a dice."""
    value = random.randint(1, sides or 6)
    await interaction.response.send_message(f'You got: {value}')


images = client.group('images', 'Cute image commands.')


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


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


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


admin = client.group(
    'admin',
    'Admin-only commands.',
    default_permission=False,
    permissions=allow_roles(ADMIN_ROLE_ID)
)
roles = admin.subgroup('roles', 'Commands to manage roles.')


@roles.subcommand(name='del')
async def del_(
        interaction: Interaction, role: Role = option('The role to delete.')):
    """Delete a role."""
    await role.delete()
    await interaction.response.send_message('Deleted the role.', ephemeral=True)


@allow_roles(ADMIN_ROLE_ID)
@client.command(default_permission=False)
async def ban(
        interaction: Interaction, user: Member = option('The user to ban.')):
    """Ban a user."""
    await user.ban()
    await interaction.response.send_message('Banned the user.', ephemeral=True)


client.run(TOKEN)

Planned Features

• Class-based command groups, like discord.ext.commands cogs.

Compatibility with discord.ext.commands is not planned.

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 --dev

The following commands are then available:

• poe format - Run auto-formatting and linting.

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