Merge pull request #329 from python-cmd2/new_quoted_completion

Adding tab completion improvements

Author: kmvanbrunt

CHANGELOG.md

@@ -1,3 +1,26 @@
+## 0.8.3 (TBD)
+* Bug Fixes
+    * Fixed ``help`` command not calling functions for help topics
+    * Fixed not being able to use quoted paths when redirecting with ``<`` and ``>``
+
+* Enhancements
+    * Tab completion has been overhauled and now supports completion of strings with quotes and spaces.
+    * Tab completion will automatically add an opening quote if a string with a space is completed.
+    * Added ``delimiter_complete`` function for tab completing delimited strings
+    * Added more control over tab completion behavior including the following flags. The use of these flags is documented in cmd2.py
+        * ``allow_appended_space``
+        * ``allow_closing_quote``
+
+* Attribute Changes (Breaks backward compatibility)
+    * ``exclude_from_help`` is now called ``hidden_commands`` since these commands are hidden from things other than help, including tab completion
+        * This list also no longer takes the function names of commands (``do_history``), but instead uses the command names themselves (``history``)
+    * ``excludeFromHistory`` is now called ``exclude_from_history``
+    * ``cmd_with_subs_completer()`` no longer takes an argument called ``base``. Adding tab completion to subcommands has been simplified to declaring it in the
+    subcommand parser's default settings. This easily allows arbitrary completers like path_complete to be used.
+    See [subcommands.py](https://github.com/python-cmd2/cmd2/blob/master/examples/subcommands.py) for an example of how to use
+    tab completion in subcommands. In addition, the docstring for ``cmd_with_subs_completer()`` offers more details.
+
+
 ## 0.8.2 (March 21, 2018)
 
 * Bug Fixes
@@ -14,7 +37,7 @@
         * See [alias_startup.py](https://github.com/python-cmd2/cmd2/blob/master/examples/alias_startup.py) for an example
     * Added a default SIGINT handler which terminates any open pipe subprocesses and re-raises a KeyboardInterrupt
     * For macOS, will load the ``gnureadline`` module if available and ``readline`` if not
-    
+
 ## 0.8.1 (March 9, 2018)
 
 * Bug Fixes
@@ -56,7 +79,7 @@
     *  See the [Argument Processing](http://cmd2.readthedocs.io/en/latest/argument_processing.html) section of the documentation for more information on these decorators
         * Alternatively, see the [argparse_example.py](https://github.com/python-cmd2/cmd2/blob/master/examples/argparse_example.py)
         and [arg_print.py](https://github.com/python-cmd2/cmd2/blob/master/examples/arg_print.py) examples
-    * Added support for Argpasre sub-commands when using the **with_argument_parser** or **with_argparser_and_unknown_args** decorators
+    * Added support for Argparse sub-commands when using the **with_argument_parser** or **with_argparser_and_unknown_args** decorators
         * See [subcommands.py](https://github.com/python-cmd2/cmd2/blob/master/examples/subcommands.py) for an example of how to use subcommands
         * Tab-completion of sub-command names is automatically supported
     * The **__relative_load** command is now hidden from the help menu by default

README.md

@@ -82,10 +82,10 @@ Instructions for implementing each feature follow.
 
 - Searchable command history
 
-    All commands will automatically be tracked in the session's history, unless the command is listed in Cmd's excludeFromHistory attribute.
+    All commands will automatically be tracked in the session's history, unless the command is listed in Cmd's exclude_from_history attribute.
     The history is accessed through the `history` command.
     If you wish to exclude some of your custom commands from the history, append their names
-    to the list at `Cmd.ExcludeFromHistory`.
+    to the list at `Cmd.exclude_from_history`.
 
 - Load commands from file, save to file, edit commands in file