feat: Make toggle auto-completion keybinding configurable

Add toggle_auto_completion_key option to pgclirc that allows users to
customize the key(s) that toggle the completion menu. Supports multiple
space-separated keys that each get their own independent binding.
Defaults to c-space for backward compatibility.

Author: devadathanmb

pgcli/key_bindings.py

@@ -189,8 +189,12 @@ def _(event):
         event.current_buffer.complete_state = None
         event.app.current_buffer.complete_state = None
 
-    @kb.add("c-space")
-    def _(event):
+    # Bind each key in toggle_completion_key to toggle completion.
+    # Space-separated keys each get their own binding.
+    # e.g., "c-space c-t" binds both Ctrl+Space and Ctrl+T independently.
+    toggle_keys = pgcli.toggle_auto_completion_key.strip().split()
+
+    def _toggle_completion(event):
         """
         Toggle autocompletion at cursor.
 
@@ -199,16 +203,15 @@ def _(event):
 
         If the menu is showing, close it (toggle off).
         """
-        _logger.debug("Detected <C-Space> key.")
-
         b = event.app.current_buffer
         if b.complete_state:
-            # Close completion menu (toggle off)
             b.complete_state = None
         else:
-            # Open completion menu (toggle on)
             b.start_completion(select_first=False)
 
+    for _key in toggle_keys:
+        kb.add(_key)(_toggle_completion)
+
     @kb.add("c-j", filter=has_completions)
     def _(event):
         """

pgcli/main.py

@@ -255,6 +255,9 @@ def __init__(
         self.column_date_formats = c["column_date_formats"]
         auth.keyring_initialize(c["main"].as_bool("keyring"), logger=self.logger)
         self.show_bottom_toolbar = c["main"].as_bool("show_bottom_toolbar")
+        self.toggle_auto_completion_key = c["main"].get(
+            "toggle_auto_completion_key", "c-space"
+        )
 
         self.pgspecial.pset_pager(self.config["main"].as_bool("enable_pager") and "on" or "off")
 

pgcli/pgclirc

@@ -154,6 +154,16 @@ syntax_style = default
 #   Ctrl+k       - Navigate to previous completion (up) - Vim style
 #   Ctrl+p       - Move up in history
 #   Ctrl+n       - Move down in history
+
+# Key binding for toggling the auto-completion menu on/off.
+# Uses prompt_toolkit key notation. Space-separated keys each
+# get their own independent binding. Examples:
+#   c-space          (Ctrl+Space - default)
+#   c-t              (Ctrl+T)
+#   c-space c-t      (both Ctrl+Space and Ctrl+T will toggle)
+# See prompt_toolkit docs for full key notation reference.
+toggle_auto_completion_key = c-space
+
 vi = False
 
 # Error handling