README/keys/ui: Add 'ALL_MENTIONS' hotkey to display @ mentions.

* ALL_MENTIONS key added to the key_category 'navigation'.
* README updated.
* Connect ALL_MENTIONS view via keypress.
* Tests added for the keypress ALL_MENTIONS.

Author: sumanthvrao

README.md

@@ -116,6 +116,7 @@ Install-Module -Name BurntToast
 | Go to the last message                                | <kbd>G</kbd> / <kbd>end</kbd>                 |
 | Narrow to all private messages                        | <kbd>P</kbd>                                  |
 | Narrow to all starred messages                        | <kbd>f</kbd>                                  |
+| Narrow to messages in which you're mentioned          | <kbd>#</kbd>                                  |
 | Next unread topic                                     | <kbd>n</kbd>                                  |
 | Next unread private message                           | <kbd>p</kbd>                                  |
 

tests/ui/test_ui.py

@@ -205,6 +205,17 @@ def test_keypress_normal_mode_navigation(self, view, mocker,
         view.keypress(size, key)
         super_view.assert_called_once_with(size, expected_key)
 
+    def test_keypress_ALL_MENTIONS(self, view, mocker):
+        view.body = mocker.Mock()
+        view.body.focus_col = None
+        view.controller.editor_mode = False
+        size = (20,)
+        view.model.controller.show_all_mentions = mocker.Mock()
+
+        view.keypress(size, "#")
+        view.model.controller.show_all_mentions.assert_called_once_with(view)
+        assert view.body.focus_col == 1
+
     @pytest.mark.parametrize('autohide', [True, False], ids=[
         'autohide', 'no_autohide'])
     def test_keypress_w(self, view, mocker, autohide):

zulipterminal/config/keys.py

@@ -140,6 +140,11 @@
         'help_text': 'Narrow to all starred messages',
         'key_category': 'navigation',
     }),
+    ('ALL_MENTIONS', {
+        'keys': {'#'},
+        'help_text': "Narrow to messages in which you're mentioned",
+        'key_category': 'navigation',
+    }),
     ('NEXT_UNREAD_TOPIC', {
         'keys': {'n'},
         'help_text': 'Next unread topic',

zulipterminal/ui.py

@@ -164,6 +164,9 @@ def keypress(self, size: Tuple[int, int], key: str) -> Optional[str]:
         elif is_command_key('ALL_STARRED', key):
             self.model.controller.show_all_starred(self)
             self.body.focus_col = 1
+        elif is_command_key('ALL_MENTIONS', key):
+            self.model.controller.show_all_mentions(self)
+            self.body.focus_col = 1
         elif is_command_key('SEARCH_PEOPLE', key):
             # Start User Search if not in editor_mode
             self.body.focus_position = 2