raito.plugins.roles.filter module

class raito.plugins.roles.filter.RoleFilter(slug, name, description, emoji)

Bases: Filter

Filter for checking user roles.

This filter is used to verify whether the user associated with a Telegram event has a specific role assigned, such as “admin”, “moderator”, etc.

It also attaches role metadata to the handler’s flags for use in command registration and visualization logic.

Parameters:

• slug (str)

• name (str)

• description (str)

• emoji (str)

classmethod from_data(data)

Create a RoleFilter from a RoleData instance.

Parameters:

data (RoleData) – RoleData instance containing role metadata

Returns:

A new RoleFilter instance

Return type:

RoleFilter

update_handler_flags(flags)

Attach role metadata to handler flags.

This allows external tools to collect and display role-related constraints.

Parameters:

flags (dict[str, Any])

Return type:

None