Module aethersprite.filters.role_filter

Classes

class RoleFilter (setting: str, multiple: bool = True)
Expand source code 
class RoleFilter(SettingFilter):
    """Filter used for converting role names to IDs and back"""

    multiple: bool = True
    """True to allow multiple values"""

    def __init__(self, setting: str, multiple: bool = True):
        super().__init__(setting)
        self.multiple = multiple

    def in_(self, ctx: Context, value: str | None) -> list[int] | None:
        """
        Filter setting input.

        Args:
            ctx: The current context
            value: The incoming value

        Returns:
            The raw setting value (a list of role IDs)
        """

        if not value:
            return

        roles = get_mixed_roles(value)
        ids = []

        for r in roles:
            id = None

            if r[0] == "":
                id = get_id_for_role(ctx.guild, r[1])
            else:
                # convert mentions, if any
                id = int(r[0])

            if id is None:
                raise ValueError(r)

            ids.append(id)

            if not self.multiple:
                break

        return ids

    def out(
        self,
        ctx: Context,
        value: list[int] | None,
    ) -> list[str | None] | str | None:
        """
        Filter setting output.

        Args:
            ctx: The current context
            value: The raw setting value: a list of role IDs

        Returns:
            The filtered setting value (a list of role names)
        """

        if value is None:
            return

        roles = [get_role_for_id(ctx.guild, v) for v in value]

        if self.multiple:
            return roles

        if len(roles) > 0:
            return roles[0]

        return None

Filter used for converting role names to IDs and back

Ancestors

Subclasses

Class variables

var multiple : bool

True to allow multiple values

Methods

def in_(self, ctx: discord.ext.commands.context.Context, value: str | None) ‑> list[int] | None
Expand source code 
def in_(self, ctx: Context, value: str | None) -> list[int] | None:
    """
    Filter setting input.

    Args:
        ctx: The current context
        value: The incoming value

    Returns:
        The raw setting value (a list of role IDs)
    """

    if not value:
        return

    roles = get_mixed_roles(value)
    ids = []

    for r in roles:
        id = None

        if r[0] == "":
            id = get_id_for_role(ctx.guild, r[1])
        else:
            # convert mentions, if any
            id = int(r[0])

        if id is None:
            raise ValueError(r)

        ids.append(id)

        if not self.multiple:
            break

    return ids

Filter setting input.

Args

ctx
The current context
value
The incoming value

Returns

The raw setting value (a list of role IDs)

def out(self, ctx: discord.ext.commands.context.Context, value: list[int] | None) ‑> list[str | None] | str | None
Expand source code 
def out(
    self,
    ctx: Context,
    value: list[int] | None,
) -> list[str | None] | str | None:
    """
    Filter setting output.

    Args:
        ctx: The current context
        value: The raw setting value: a list of role IDs

    Returns:
        The filtered setting value (a list of role names)
    """

    if value is None:
        return

    roles = [get_role_for_id(ctx.guild, v) for v in value]

    if self.multiple:
        return roles

    if len(roles) > 0:
        return roles[0]

    return None

Filter setting output.

Args

ctx
The current context
value
The raw setting value: a list of role IDs

Returns

The filtered setting value (a list of role names)

Inherited members