slidge_whatsapp.group

Classes

Participant	A legacy participant of a legacy group chat.
MUC	A room, a.k.a. a Multi-User Chat.
Bookmarks	This is instantiated once per BaseSession

Functions

replace_xmpp_mentions(text, mentions)
replace_whatsapp_mentions(text, participants)

Module Contents

class slidge_whatsapp.group.Participant(muc, nickname=None, is_user=False, is_system=False, role='participant', affiliation='member')

Bases: slidge.group.LegacyParticipant

A legacy participant of a legacy group chat.

Parameters:

• muc (slidge.group.room.LegacyMUC) –

• nickname (Optional[str]) –

• role (slidge.util.types.MucRole) –

• affiliation (slidge.util.types.MucAffiliation) –

contact: slidge_whatsapp.contact.Contact

muc: MUC

class slidge_whatsapp.group.MUC(session, legacy_id, jid)

Bases: slidge.group.LegacyMUC[str, str, Participant, str]

A room, a.k.a. a Multi-User Chat.

MUC instances are obtained by calling slidge.group.bookmarks.LegacyBookmarks() on the user’s slidge.core.session.BaseSession.

Parameters:

• session (slidge.core.session.BaseSession) –

• legacy_id (slidge.util.types.LegacyGroupIdType) –

• jid (slixmpp.JID) –

session: slidge_whatsapp.session.Session

type

HAS_DESCRIPTION = False

Set this to false if the legacy network does not allow setting a description for the group. In this case the description field will not be present in the room configuration form.

REACTIONS_SINGLE_EMOJI = True

_ALL_INFO_FILLED_ON_STARTUP = True

Set this to true if the fill_participants() / fill_participants() design does not fit the legacy API, ie, no lazy loading of the participant list and history.

async update_info()

Fetch information about this group from the legacy network

This is awaited on MUC instantiation, and should be overridden to update the attributes of the group chat, like title, subject, number of participants etc.

To take advantage of the slidge avatar cache, you can check the .avatar property to retrieve the “legacy file ID” of the cached avatar. If there is no change, you should not call slidge.core.mixins.avatar.AvatarMixin.set_avatar() or attempt to modify the :attr:.avatar property.

async backfill(after=None, before=None)

Request history for messages older than the oldest message given by ID and date.

Parameters:

• after (slidge.util.types.HoleBound | None) –

• before (slidge.util.types.HoleBound | None) –

get_message_sender(legacy_msg_id)

Parameters:

legacy_msg_id (str) –

async update_whatsapp_info(info)

Set MUC information based on WhatsApp group information, which may or may not be partial in case of updates to existing MUCs.

Parameters:

info (slidge_whatsapp.generated.whatsapp.Group) –

async fill_participants()

This method should yield the list of all members of this group.

Typically, use participant = self.get_participant(), self.get_participant_by_contact(), of self.get_user_participant(), and update their affiliation, hats, etc. before yielding them.

Return type:

AsyncIterator[Participant]

async replace_mentions(t)

Parameters:

t (str) –

async on_avatar(data, mime)

Called when the user tries to set the avatar of the room from an XMPP client.

If the set avatar operation is completed, should return a legacy image unique identifier. In this case the MUC avatar will be immediately updated on the XMPP side.

If data is not None and this method returns None, then we assume that self.set_avatar() will be called elsewhere, eg triggered by a legacy room update event.

Parameters:

• data (Optional[bytes]) – image data or None if the user meant to remove the avatar

• mime (Optional[str]) – the mime type of the image. Since this is provided by the XMPP client, there is no guarantee that this is valid or correct.

Returns:

A unique avatar identifier, which will trigger slidge.group.room.LegacyMUC.set_avatar(). Alternatively, None, if LegacyMUC.set_avatar() is meant to be awaited somewhere else.

Return type:

None

async on_set_config(name, description)

Triggered when the user requests changing the room configuration. Only title and description can be changed at the moment.

The legacy module is responsible for updating title and/or description of this instance.

If HAS_DESCRIPTION is set to False, description will always be None.

Parameters:

• name (Optional[str]) – The new name of the room.

• description (Optional[str]) – The new description of the room.

async on_set_subject(subject)

Triggered when the user requests changing the room subject.

The legacy module is responsible for updating subject of this instance.

Parameters:

subject (str) – The new subject for this room.

async on_set_affiliation(contact, affiliation, reason, nickname)

Triggered when the user requests changing the affiliation of a contact for this group.

Examples: promotion them to moderator, ban (affiliation=outcast).

Parameters:

• contact (slidge_whatsapp.contact.Contact) – The contact whose affiliation change is requested

• affiliation (slidge.util.types.MucAffiliation) – The new affiliation

• reason (Optional[str]) – A reason for this affiliation change

• nickname (Optional[str]) –

class slidge_whatsapp.group.Bookmarks(session)

Bases: slidge.group.LegacyBookmarks[str, MUC]

This is instantiated once per BaseSession

Parameters:

session (slidge_whatsapp.session.Session) –

session: slidge_whatsapp.session.Session

__filled = False

async fill()

Establish a user’s known groups.

This has to be overridden in plugins with group support and at the minimum, this should await self.by_legacy_id(group_id) for all the groups a user is part of.

Slidge internals will call this on successful BaseSession.login()

async add_whatsapp_group(data)

Parameters:

data (slidge_whatsapp.generated.whatsapp.Group) –

async legacy_id_to_jid_local_part(legacy_id)

Parameters:

legacy_id (str) –

async jid_local_part_to_legacy_id(local_part)

Parameters:

local_part (str) –

slidge_whatsapp.group.replace_xmpp_mentions(text, mentions)

Parameters:

• text (str) –

• mentions (list[slidge.util.types.Mention]) –

slidge_whatsapp.group.replace_whatsapp_mentions(text, participants)

Parameters:

• text (str) –

• participants (dict[str, str]) –