Fix changes requested (#101)
- Fix code formatting issues. - Document `Presence`. - Improve `Presence.__lt__()` performance by defining a dict outside the method. - Make presence ball radius relative to uiScale and configurable from theme.
This commit is contained in:
@@ -82,6 +82,9 @@ class Backend:
|
||||
we managed. Every client is logged to one matrix account.
|
||||
|
||||
media_cache: A matrix media cache for downloaded files.
|
||||
|
||||
presences: A `{user_id: Presence}` dict for storing presence info about
|
||||
matrix users registered on Mirage.
|
||||
"""
|
||||
|
||||
def __init__(self) -> None:
|
||||
|
@@ -232,9 +232,10 @@ class MatrixClient(nio.AsyncClient):
|
||||
|
||||
|
||||
async def login(
|
||||
self, password: str,
|
||||
device_name: str = "",
|
||||
order: Optional[int] = None,
|
||||
self,
|
||||
password: str,
|
||||
device_name: str = "",
|
||||
order: Optional[int] = None,
|
||||
) -> None:
|
||||
"""Login to the server using the account's password."""
|
||||
|
||||
@@ -242,12 +243,14 @@ class MatrixClient(nio.AsyncClient):
|
||||
password, device_name or self.default_device_name(),
|
||||
)
|
||||
|
||||
if order is None and not self.models["accounts"]:
|
||||
saved = await self.backend.saved_accounts.read()
|
||||
|
||||
if order is None and not saved.values():
|
||||
order = 0
|
||||
elif order is None:
|
||||
order = max(
|
||||
account.order
|
||||
for i, account in enumerate(self.models["accounts"].values())
|
||||
account.get("order", i)
|
||||
for i, account in enumerate(saved.values())
|
||||
) + 1
|
||||
|
||||
# Get or create account model
|
||||
@@ -519,10 +522,8 @@ class MatrixClient(nio.AsyncClient):
|
||||
mentions = mentions,
|
||||
)
|
||||
|
||||
while (
|
||||
self.models["accounts"][self.user_id].presence ==
|
||||
Presence.State.offline
|
||||
):
|
||||
presence = self.models["accounts"][self.user_id].presence
|
||||
while presence == Presence.State.offline:
|
||||
await asyncio.sleep(0.2)
|
||||
|
||||
await self._send_message(room_id, content, tx_id)
|
||||
@@ -550,10 +551,8 @@ class MatrixClient(nio.AsyncClient):
|
||||
async def send_file(self, room_id: str, path: Union[Path, str]) -> None:
|
||||
"""Send a `m.file`, `m.image`, `m.audio` or `m.video` message."""
|
||||
|
||||
while (
|
||||
self.models["accounts"][self.user_id].presence ==
|
||||
Presence.State.offline
|
||||
):
|
||||
presence = self.models["accounts"][self.user_id].presence
|
||||
while presence == Presence.State.offline:
|
||||
await asyncio.sleep(0.2)
|
||||
|
||||
item_uuid = uuid4()
|
||||
@@ -1123,10 +1122,8 @@ class MatrixClient(nio.AsyncClient):
|
||||
"""Set typing notice to the server."""
|
||||
|
||||
# Do not send typing notice if the user is invisible
|
||||
if (
|
||||
self.models["accounts"][self.user_id].presence not in
|
||||
[Presence.State.invisible, Presence.State.offline]
|
||||
):
|
||||
presence = self.models["accounts"][self.user_id].presence
|
||||
if presence not in [Presence.State.invisible, Presence.State.offline]:
|
||||
await super().room_typing(room_id, typing_state, timeout)
|
||||
|
||||
|
||||
@@ -1304,20 +1301,20 @@ class MatrixClient(nio.AsyncClient):
|
||||
|
||||
await self._stop()
|
||||
|
||||
# Uppdate manually since we may not receive the presence event back
|
||||
# Update manually since we may not receive the presence event back
|
||||
# in time
|
||||
account.presence = Presence.State.offline
|
||||
account.currently_active = False
|
||||
elif (
|
||||
presence != "offline" and
|
||||
account.presence == Presence.State.offline
|
||||
account.presence == Presence.State.offline and
|
||||
presence != "offline"
|
||||
):
|
||||
account.connecting = True
|
||||
self.start_task = asyncio.ensure_future(self._start())
|
||||
self.start_task = asyncio.ensure_future(self._start())
|
||||
|
||||
if (
|
||||
presence != "offline" and
|
||||
Presence.State(presence) != account.presence
|
||||
Presence.State(presence) != account.presence and
|
||||
presence != "offline"
|
||||
):
|
||||
account.presence = Presence.State("echo_" + presence)
|
||||
|
||||
@@ -1689,7 +1686,7 @@ class MatrixClient(nio.AsyncClient):
|
||||
async def add_member(self, room: nio.MatrixRoom, user_id: str) -> None:
|
||||
"""Register/update a room member into our models."""
|
||||
member = room.users[user_id]
|
||||
presence = self.backend.presences.get(user_id, Presence())
|
||||
presence = self.backend.presences.get(user_id, None)
|
||||
member_item = Member(
|
||||
id = user_id,
|
||||
display_name = room.user_name(user_id) # disambiguated
|
||||
@@ -1701,8 +1698,8 @@ class MatrixClient(nio.AsyncClient):
|
||||
)
|
||||
|
||||
# Associate presence with member, if it exists
|
||||
if user_id in self.backend.presences:
|
||||
presence.members[room.room_id, user_id] = member_item
|
||||
if presence:
|
||||
presence.members[room.room_id] = member_item
|
||||
|
||||
# And then update presence fields
|
||||
presence.update_members()
|
||||
|
@@ -17,6 +17,11 @@ from .model_item import ModelItem
|
||||
|
||||
ZeroDate = datetime.fromtimestamp(0)
|
||||
OptionalExceptionType = Union[Type[None], Type[Exception]]
|
||||
PresenceOrder: Dict[str, int] = {
|
||||
"online": 0,
|
||||
"unavailable": 1,
|
||||
"offline": 2,
|
||||
}
|
||||
|
||||
|
||||
class TypeSpecifier(AutoStrEnum):
|
||||
@@ -28,7 +33,38 @@ class TypeSpecifier(AutoStrEnum):
|
||||
|
||||
|
||||
@dataclass
|
||||
class Presence():
|
||||
class Presence:
|
||||
"""Represents a single matrix user presence fields.
|
||||
|
||||
It is stored in `Backend.presences`, indexed by user ID. It must only be
|
||||
instiated when receiving a `PresenceEvent` or registering an `Account`
|
||||
model.
|
||||
|
||||
When receiving a `PresenceEvent`, we get or create a `Presence` object in
|
||||
`Backend.presences` for the targeted user. If the user is registered in any
|
||||
room, add its `Member` object to `members`. And finally update every
|
||||
`Member` presence fields inside `members`.
|
||||
|
||||
When a room member is registered, we try to find a `Presence` in
|
||||
`Backend.presences` for that user ID. If found, add the member to
|
||||
`members`.
|
||||
|
||||
When an Account model is registered, we create a `Presence` in
|
||||
`Backend.presences` for account ID wether the server supports or not
|
||||
presence (we cannot really know at this point). And assign that `Account`
|
||||
to `Account` field.
|
||||
|
||||
Attributes:
|
||||
members: A `{room_id: Member}` dict for storing room members related to
|
||||
this `Presence`. As each room has its own `Member`s objects, we
|
||||
have to keep track of their presence fields. `Member`s are indexed
|
||||
by room ID.
|
||||
|
||||
account: `Account` related to this `Presence` (if any). Should only be
|
||||
assigned when client starts (`MatrixClient._start()`) and
|
||||
unassigned when client stops (`MatrixClient._start()`).
|
||||
"""
|
||||
|
||||
class State(AutoStrEnum):
|
||||
offline = auto() # can mean offline, invisible or unknwon
|
||||
unavailable = auto()
|
||||
@@ -40,28 +76,24 @@ class Presence():
|
||||
echo_invisible = auto()
|
||||
|
||||
def __lt__(self, other: "Presence.State") -> bool:
|
||||
order = [
|
||||
self.online,
|
||||
self.unavailable,
|
||||
self.invisible,
|
||||
self.offline,
|
||||
]
|
||||
return PresenceOrder[self.value] < PresenceOrder[other.value]
|
||||
|
||||
return (
|
||||
order.index(self) # type: ignore
|
||||
) < (
|
||||
order.index(other) # type: ignore
|
||||
)
|
||||
|
||||
presence: State = State.offline
|
||||
currently_active: bool = False
|
||||
last_active_at: datetime = ZeroDate
|
||||
status_msg: str = ""
|
||||
|
||||
members: Dict[Tuple[str, str], "Member"] = field(default_factory=dict)
|
||||
account: Optional["Account"] = None
|
||||
members: Dict[str, "Member"] = field(default_factory=dict)
|
||||
account: Optional["Account"] = None
|
||||
|
||||
def update_members(self) -> None:
|
||||
"""Update presence fields of every `M̀ember` in `members`.
|
||||
|
||||
Currently it is only called when receiving a `PresenceEvent` and when
|
||||
registering room members.
|
||||
"""
|
||||
|
||||
for member in self.members.values():
|
||||
member.presence = self.presence
|
||||
member.status_msg = self.status_msg
|
||||
@@ -69,6 +101,8 @@ class Presence():
|
||||
member.currently_active = self.currently_active
|
||||
|
||||
def update_account(self) -> None:
|
||||
"""Update presence fields of `Account` related to this `Presence`."""
|
||||
|
||||
# Do not update if account is changing to invisible.
|
||||
# When setting presence to invisible, the server will give us a
|
||||
# presence event telling us we are offline, but we do not want to set
|
||||
|
@@ -593,13 +593,14 @@ class NioCallbacks:
|
||||
async def onPresenceEvent(self, ev: nio.PresenceEvent) -> None:
|
||||
presence = self.client.backend.presences.get(ev.user_id, Presence())
|
||||
|
||||
presence.currently_active = ev.currently_active or False
|
||||
presence.status_msg = ev.status_msg or ""
|
||||
presence.presence = Presence.State(ev.presence) if ev.presence\
|
||||
else Presence.State.offline
|
||||
presence.last_active_at = (
|
||||
datetime.now() - timedelta(milliseconds=ev.last_active_ago)
|
||||
) if ev.last_active_ago else datetime.fromtimestamp(0)
|
||||
presence.currently_active = ev.currently_active or False
|
||||
|
||||
presence.presence = Presence.State(ev.presence) if ev.presence\
|
||||
else Presence.State.offline
|
||||
|
||||
# Add all existing members related to this presence
|
||||
for room_id in self.models[self.user_id, "rooms"]:
|
||||
@@ -608,7 +609,7 @@ class NioCallbacks:
|
||||
)
|
||||
|
||||
if member:
|
||||
presence.members[room_id, ev.user_id] = member
|
||||
presence.members[room_id] = member
|
||||
|
||||
# Update members and accounts
|
||||
presence.update_members()
|
||||
@@ -624,7 +625,7 @@ class NioCallbacks:
|
||||
):
|
||||
account = self.models["accounts"][ev.user_id]
|
||||
|
||||
# Do not fight back presence
|
||||
# Do not fight back presence from other clients
|
||||
self.client.backend.clients[ev.user_id]._presence = ev.presence
|
||||
|
||||
# Servers that send presence events support presence
|
||||
|
@@ -194,12 +194,7 @@ class Accounts(JSONDataFile):
|
||||
"device_id": client.device_id,
|
||||
"enabled": True,
|
||||
"presence": account.presence.value,
|
||||
|
||||
# Can account.order converge with any other saved value?
|
||||
"order": account.order if account.order >= 0 else max([
|
||||
account.get("order", i)
|
||||
for i, account in enumerate(saved.values())
|
||||
] or [-1]) + 1,
|
||||
"order": account.order,
|
||||
},
|
||||
})
|
||||
|
||||
|
Reference in New Issue
Block a user