[Feature] Add a setting to allow filter of plugin commands on package.

This commit adds a new setting `filter_plugin_commands_on_package` to
allow a user to filter the command list based on the package name.

Author: UltraInstinct05

resources/CommandsBrowser.sublime-settings

@@ -48,5 +48,7 @@
     // https://www.sublimetext.com/docs/api_reference.html#type-event_dict
     //
     // The default value for this setting is "ctrl".
-    "copy_command_signature_modifier_key": "ctrl"
+    "copy_command_signature_modifier_key": "ctrl",
+
+    "filter_plugin_commands_on_package": "all"
 }

src/commands/commands_browser_plugin_commands.py

@@ -6,7 +6,7 @@
 )
 
 from ..settings import commands_browser_settings
-from ..utils.miscellaneous_utils import log, filter_command_types
+from ..utils.miscellaneous_utils import log, filter_command_types, filter_package_setting
 
 
 class CommandsBrowserPluginCommandsCommand(sublime_plugin.ApplicationCommand):
@@ -39,6 +39,7 @@ def run(self, cmd_dict = None):
             host = "all"
 
         cmd_type_filter_list = filter_command_types("filter_plugin_commands_on_type")
+        package_filter = filter_package_setting()
 
         for _, details in cmd_dict.items():
 
@@ -49,6 +50,12 @@ def run(self, cmd_dict = None):
             if details["type"] not in cmd_type_filter_list:
                 continue
 
+            if package_filter == "all":
+                pass
+            else:
+                if details["pkg"] not in package_filter:
+                    continue
+
             items.append(
                 sublime.QuickPanelItem(
                     trigger = details["name"],

src/settings.py

@@ -16,7 +16,8 @@ def load_commands_browser_settings():
         "filter_plugin_commands_on_host": "all",
         "filter_plugin_commands_on_type": ["text", "window", "application"],
         "filter_core_commands_on_type": ["text", "window", "application", "find"],
-        "copy_command_signature_modifier_key": "ctrl"
+        "copy_command_signature_modifier_key": "ctrl",
+        "filter_plugin_commands_on_package": "all"
     }
 
 

src/utils/miscellaneous_utils.py

@@ -67,3 +67,26 @@ def filter_command_types(setting_name):
         cmd_type_filter_list = commands_browser_settings.default.get(f"{setting_name}")
 
     return cmd_type_filter_list
+
+
+def filter_package_setting():
+    """ Filters the setting 'filter_plugin_commands_on_package' to get rid of
+    any invalid values a user may set and sanitize it to sane defaults.
+
+    Args:
+        None
+
+    Returns:
+        package_filter (string | List[str]): The sanitised package filter list.
+    """
+    package_filter = commands_browser_settings("filter_plugin_commands_on_package")
+
+    if (
+        ((type(package_filter) != str) and (type(package_filter) != list)) or
+        (package_filter == "all")
+    ):
+        log(f"""'{package_filter}' is an invalid value for the setting
+        'filter_plugin_commands_on_package'. Falling back to default value.""")
+        package_filter = "all"
+
+    return package_filter