Merge branch 'master' into completion_state

Author: kmvanbrunt

CHANGELOG.md

@@ -4,10 +4,11 @@
     * Fixed a bug when running a cmd2 application on Linux without Gtk libraries installed
 * Enhancements
     * No longer treating empty text scripts as an error condition
+    * Allow dynamically extending a `cmd2.Cmd` object instance with a `do_xxx` method at runtime
     * Choices/Completer functions can now be passed a dictionary that maps command-line tokens to their
     argparse argument. This is helpful when one argument determines what is tab completed for another argument.
     If these functions have an argument called `arg_tokens`, then AutoCompleter will automatically pass this
-    Namespace to them.
+    dictionary to them.
 
 ## 0.9.16 (August 7, 2019)
 * Bug Fixes

cmd2/cmd2.py

@@ -1606,6 +1606,10 @@ def _autocomplete_default(self, text: str, line: str, begidx: int, endidx: int,
         tokens_to_parse = raw_tokens if preserve_quotes else tokens
         return completer.complete_command(tokens_to_parse, text, line, begidx, endidx)
 
+    def get_names(self):
+        """Return an alphabetized list of names comprising the attributes of the cmd2 class instance."""
+        return dir(self)
+
     def get_all_commands(self) -> List[str]:
         """Return a list of all commands"""
         return [name[len(COMMAND_FUNC_PREFIX):] for name in self.get_names()

examples/dynamic_commands.py

@@ -0,0 +1,31 @@
+#!/usr/bin/env python3
+# coding=utf-8
+"""A simple example demonstrating how do_* commands can be created in a loop.
+"""
+import functools
+import cmd2
+COMMAND_LIST = ['foo', 'bar', 'baz']
+
+
+class CommandsInLoop(cmd2.Cmd):
+    """Example of dynamically adding do_* commands."""
+    def __init__(self):
+        super().__init__(use_ipython=True)
+
+    def send_text(self, args: cmd2.Statement, *, text: str):
+        """Simulate sending text to a server and printing the response."""
+        self.poutput(text.capitalize())
+
+    def text_help(self, *, text: str):
+        """Deal with printing help for the dynamically added commands."""
+        self.poutput("Simulate sending {!r} to a server and printing the response".format(text))
+
+
+for command in COMMAND_LIST:
+    setattr(CommandsInLoop, 'do_{}'.format(command), functools.partialmethod(CommandsInLoop.send_text, text=command))
+    setattr(CommandsInLoop, 'help_{}'.format(command), functools.partialmethod(CommandsInLoop.text_help, text=command))
+
+
+if __name__ == '__main__':
+    app = CommandsInLoop()
+    app.cmdloop()