Added back bash_complete() helper function to argcomplete_bridge.py

This is intended to be used once a new example is added to show how to use the code present in argcomplete_bridge.

This was previously used by the subcommands.py example, but I deleted the argcomplete_bridge code from there to simplify that example and make it focused on subcommands.

Author: tleonhardt

cmd2/argcomplete_bridge.py

@@ -16,6 +16,7 @@
     except AttributeError:
         DEFAULT_COMPLETER = argcomplete.completers.FilesCompleter()
 
+    from cmd2.argparse_completer import ACTION_ARG_CHOICES, ACTION_SUPPRESS_HINT
     from contextlib import redirect_stdout
     import copy
     from io import StringIO
@@ -250,3 +251,15 @@ def __call__(self, argument_parser, completer=None, always_complete_options=True
             output_stream.flush()
             argcomplete.debug_stream.flush()
             exit_method(0)
+
+
+    def bash_complete(action, show_hint: bool = True):
+        """Helper function to configure an argparse action to fall back to bash completion.
+
+        This function tags a parameter for bash completion, bypassing the autocompleter (for file input).
+        """
+        def complete_none(*args, **kwargs):
+            return None
+
+        setattr(action, ACTION_SUPPRESS_HINT, not show_hint)
+        setattr(action, ACTION_ARG_CHOICES, (complete_none,))