Implement global prefix handler

Author: AndhaPaisa

pyrogram/client.py

@@ -222,6 +222,12 @@ class Client(Methods):
 
         link_preview_options (:obj:`~pyrogram.types.LinkPreviewOptions`, *optional*):
             Global link preview options for the client.
+            
+        prefixes (``str`` | ``list``, *optional*):
+            Global command prefix or list of prefixes for the client, used as the default by
+            :func:`~pyrogram.filters.command` whenever a handler doesn't pass its own
+            ``prefixes`` argument. Defaults to "/" (slash). Examples: "!", ["/", "!", "."].
+            Pass None or "" (empty string) to allow commands with no prefix at all by default.
 
         fetch_replies (``bool``, *optional*):
             Pass True to automatically fetch replies for messages.
@@ -310,6 +316,7 @@ def __init__(
         storage_engine: Optional[Storage] = None,
         client_platform: "enums.ClientPlatform" = enums.ClientPlatform.OTHER,
         link_preview_options: Optional[LinkPreviewOptions] = None,
+        prefixes: Optional[Union[str, List[str]]] = "/",
         fetch_replies: Optional[bool] = True,
         fetch_topics: Optional[bool] = True,
         fetch_stories: Optional[bool] = True,
@@ -353,6 +360,10 @@ def __init__(
         self.max_topic_cache_size = max_topic_cache_size
         self.client_platform = client_platform
         self.link_preview_options = link_preview_options
+
+        _prefixes = [] if prefixes is None else prefixes
+        _prefixes = _prefixes if isinstance(_prefixes, list) else [_prefixes]
+        self.prefixes = set(_prefixes) if _prefixes else {""}
         self.fetch_replies = fetch_replies
         self.fetch_topics = fetch_topics
         self.fetch_stories = fetch_stories

pyrogram/filters.py

@@ -985,7 +985,21 @@ async def gift_offer_rejected_filter(_, __, m: Message):
 # endregion
 
 # region command_filter
-def command(commands: Union[str, List[str]], prefixes: Optional[Union[str, List[str]]] = "/", case_sensitive: bool = False):
+class _NotSet:
+    def __repr__(self):
+        return "<default client prefixes>"
+
+
+COMMAND_PREFIX_NOT_SET = _NotSet()
+"""Sentinel used by :func:`~pyrogram.filters.command` to detect that *prefixes* was not
+explicitly passed, so the filter should fall back to the ``Client(prefixes=...)`` value."""
+
+
+def command(
+    commands: Union[str, List[str]],
+    prefixes: Optional[Union[str, List[str]]] = COMMAND_PREFIX_NOT_SET,
+    case_sensitive: bool = False
+):
     """Filter commands, i.e.: text messages starting with "/" or any other custom prefix.
 
     Parameters:
@@ -997,7 +1011,9 @@ def command(commands: Union[str, List[str]], prefixes: Optional[Union[str, List[
 
         prefixes (``str`` | ``list``, *optional*):
             A prefix or a list of prefixes as string the filter should look for.
-            Defaults to "/" (slash). Examples: ".", "!", ["/", "!", "."], list(".:!").
+            Defaults to the prefixes configured on the :obj:`~pyrogram.Client` (via the
+            ``prefixes`` parameter of :meth:`~pyrogram.Client`), which itself defaults to "/"
+            (slash) when not set. Examples: ".", "!", ["/", "!", "."], list(".:!").
             Pass None or "" (empty string) to allow commands with no prefix at all.
 
         case_sensitive (``bool``, *optional*):
@@ -1014,7 +1030,13 @@ async def func(flt, client: pyrogram.Client, message: Message):
         if not text:
             return False
 
-        for prefix in flt.prefixes:
+        prefixes = flt.prefixes
+
+        if prefixes is COMMAND_PREFIX_NOT_SET:
+            client_prefixes = getattr(client, "prefixes", None)
+            prefixes = client_prefixes if client_prefixes else {"/"}
+
+        for prefix in prefixes:
             if not text.startswith(prefix):
                 continue
 
@@ -1044,9 +1066,12 @@ async def func(flt, client: pyrogram.Client, message: Message):
     commands = commands if isinstance(commands, list) else [commands]
     commands = {c if case_sensitive else c.lower() for c in commands}
 
-    prefixes = [] if prefixes is None else prefixes
-    prefixes = prefixes if isinstance(prefixes, list) else [prefixes]
-    prefixes = set(prefixes) if prefixes else {""}
+    if prefixes is COMMAND_PREFIX_NOT_SET:
+        prefixes = COMMAND_PREFIX_NOT_SET
+    else:
+        prefixes = [] if prefixes is None else prefixes
+        prefixes = prefixes if isinstance(prefixes, list) else [prefixes]
+        prefixes = set(prefixes) if prefixes else {""}
 
     return create(
         func,