conversation: Add recent conversations view to zulip-terminal.

Implemented a new RecentConversationsView in ui_tools/views.py to display
recent conversation data fetched via model.py. Updated core.py and ui.py to
integrate this view into the main application flow. Modified cli/run.py to
support initialization of conversation data, and adjusted keys.py and
ui_sizes.py for navigation and layout consistency. Added button support in
ui_tools/buttons.py for interacting with conversations.

This enhances zulip-terminal’s interactivity by allowing users to view and
navigate recent conversations, addressing requirements from issue zulip#1565.

Fixes zulip#1565.

Author: sahith-ch

zulipterminal/cli/run.py

@@ -696,4 +696,3 @@ def print_setting(setting: str, data: SettingData, suffix: str = "") -> None:
 
 if __name__ == "__main__":
     main()
-    

zulipterminal/core.py

@@ -47,7 +47,6 @@
     StreamInfoView,
     StreamMembersView,
     UserInfoView,
-    
 )
 from zulipterminal.version import ZT_VERSION
 
@@ -598,7 +597,7 @@ def _narrow_to(self, anchor: Optional[int], **narrow: Any) -> None:
 
         if already_narrowed and anchor is None:
             return
-        
+
         msg_id_list = self.model.get_message_ids_in_current_narrow()
 
         # If no messages are found in the current narrow

zulipterminal/model.py

@@ -8,7 +8,7 @@
 from collections import defaultdict
 from concurrent.futures import Future, ThreadPoolExecutor, wait
 from copy import deepcopy
-from datetime import datetime,timezone
+from datetime import datetime, timezone
 from typing import (
     Any,
     Callable,
@@ -314,7 +314,6 @@ def set_narrow(
             frozenset(["pm_with"]): [["pm-with", pm_with]],
             frozenset(["starred"]): [["is", "starred"]],
             frozenset(["mentioned"]): [["is", "mentioned"]],
-
         }
         for narrow_param, narrow in valid_narrows.items():
             if narrow_param == selected_params:
@@ -856,7 +855,6 @@ def modernize_message_response(message: Message) -> Message:
                 message["topic_links"] = topic_links
 
         return message
-        
 
     def fetch_message_history(
         self, message_id: int
@@ -1095,10 +1093,13 @@ def get_other_subscribers_in_stream(
                 if stream["name"] == stream_name
                 if sub != self.user_id
             ]
+
     def group_recent_conversations(self) -> List[Dict[str, Any]]:
         """Return the 10 most recent stream conversations."""
         # Filter for stream messages
-        stream_msgs = [m for m in self.index["messages"].values() if m["type"] == "stream"]
+        stream_msgs = [
+            m for m in self.index["messages"].values() if m["type"] == "stream"
+        ]
         if not stream_msgs:
             return []
 
@@ -1114,11 +1115,13 @@ def group_recent_conversations(self) -> List[Dict[str, Any]]:
         processed_conversations = []
         now = datetime.now(timezone.utc)
         for (stream_id, topic), msg_list in sorted(
-            convos.items(), key=lambda x: max(m["timestamp"] for m in x[1]), reverse=True
+            convos.items(),
+            key=lambda x: max(m["timestamp"] for m in x[1]),
+            reverse=True,
         )[:10]:
             # Map stream_id to stream name
 
-            stream_name=self.stream_name_from_id(stream_id)
+            stream_name = self.stream_name_from_id(stream_id)
             topic_name = topic if topic else "(no topic)"
 
             # Extract participants
@@ -1137,14 +1140,17 @@ def group_recent_conversations(self) -> List[Dict[str, Any]]:
                 hours = delta.seconds // 3600
                 time_str = f"{hours} hours ago" if hours > 0 else "just now"
 
-            processed_conversations.append({
-                "stream": stream_name,
-                "topic": topic_name,
-                "participants": list(participants),
-                "time": time_str,
-            })
+            processed_conversations.append(
+                {
+                    "stream": stream_name,
+                    "topic": topic_name,
+                    "participants": list(participants),
+                    "time": time_str,
+                }
+            )
+
+        return processed_conversations
 
-        return processed_conversations    
     def _clean_and_order_custom_profile_data(
         self, custom_profile_data: Dict[str, CustomFieldValue]
     ) -> List[CustomProfileData]:
@@ -1467,7 +1473,8 @@ def stream_id_from_name(self, stream_name: str) -> int:
             if stream["name"] == stream_name:
                 return stream_id
         raise RuntimeError("Invalid stream name.")
-    def stream_name_from_id(self,stream_id:int)->str:
+
+    def stream_name_from_id(self, stream_id: int) -> str:
         return self.stream_dict[stream_id]["name"]
 
     def stream_access_type(self, stream_id: int) -> StreamAccessType:

zulipterminal/ui.py

@@ -72,7 +72,7 @@ def middle_column_view(self) -> Any:
         self.middle_column = MiddleColumnView(
             self, self.model, self.write_box, self.search_box
         )
-        
+
         return urwid.LineBox(
             self.middle_column,
             title="Messages",

zulipterminal/ui_tools/buttons.py

@@ -24,7 +24,7 @@
     MENTIONED_MESSAGES_MARKER,
     MUTE_MARKER,
     STARRED_MESSAGES_MARKER,
-    TIME_MENTION_MARKER
+    TIME_MENTION_MARKER,
 )
 from zulipterminal.config.ui_mappings import EDIT_MODE_CAPTIONS, STREAM_ACCESS_TYPE
 from zulipterminal.helper import StreamData, hash_util_decode, process_media
@@ -130,9 +130,7 @@ def keypress(self, size: urwid_Size, key: str) -> Optional[str]:
 
 class HomeButton(TopButton):
     def __init__(self, *, controller: Any, count: int) -> None:
-        button_text = (
-            f"All messages           [{primary_display_key_for_command('ALL_MESSAGES')}]"
-        )
+        button_text = f"All messages           [{primary_display_key_for_command('ALL_MESSAGES')}]"
 
         super().__init__(
             controller=controller,
@@ -146,7 +144,9 @@ def __init__(self, *, controller: Any, count: int) -> None:
 
 class PMButton(TopButton):
     def __init__(self, *, controller: Any, count: int) -> None:
-        button_text = f"Direct messages        [{primary_display_key_for_command('ALL_PM')}]"
+        button_text = (
+            f"Direct messages        [{primary_display_key_for_command('ALL_PM')}]"
+        )
 
         super().__init__(
             controller=controller,
@@ -160,9 +160,7 @@ def __init__(self, *, controller: Any, count: int) -> None:
 
 class MentionedButton(TopButton):
     def __init__(self, *, controller: Any, count: int) -> None:
-        button_text = (
-            f"Mentions               [{primary_display_key_for_command('ALL_MENTIONS')}]"
-        )
+        button_text = f"Mentions               [{primary_display_key_for_command('ALL_MENTIONS')}]"
 
         super().__init__(
             controller=controller,
@@ -172,11 +170,11 @@ def __init__(self, *, controller: Any, count: int) -> None:
             show_function=controller.narrow_to_all_mentions,
             count=count,
         )
-class TimeMentionedButton(TopButton):  
+
+
+class TimeMentionedButton(TopButton):
     def __init__(self, *, controller: Any, count: int) -> None:
-        button_text = (
-            f"Recent Conversations  [{primary_display_key_for_command('OPEN_RECENT_CONVERSATIONS')}]"
-        )
+        button_text = f"Recent Conversations  [{primary_display_key_for_command('OPEN_RECENT_CONVERSATIONS')}]"
         super().__init__(
             controller=controller,
             prefix_markup=("title", TIME_MENTION_MARKER),