[Settable] address typo, docstring format, Added unit test and updated getting_started example

Author: neoniobium

CHANGELOG.md

@@ -1,7 +1,7 @@
 ## (TBA)
 
 - Enhancements
-    - Added possibility to use rich Text objects to set the description argument of a `Settanble`
+    - Added possibility to use rich Text objects to set the description argument of a `Settable`
 
 ## 4.1.1 (July 9, 2026)
 

cmd2/utils.py

@@ -111,8 +111,7 @@ def __init__(
                          input is a valid integer. Specifying bool automatically provides
                          completion for 'true' and 'false' and uses a built-in function
                          for conversion and validation.
-        :param description: A concise string or rich Text object that describes the purpose of
-                         this setting.
+        :param description: A concise string or rich Text object that describes the purpose of this setting.
         :param settable_object: The object that owns the attribute being made settable (e.g. self).
         :param settable_attrib_name: The name of the attribute on the settable_object that
                                      will be modified. This defaults to the value of the name

examples/getting_started.py

@@ -31,6 +31,7 @@
 from prompt_toolkit.application import get_app
 from prompt_toolkit.formatted_text import AnyFormattedText
 from rich.style import Style
+from rich.text import Text
 
 import cmd2
 from cmd2 import (
@@ -94,7 +95,16 @@ def __init__(self) -> None:
             cmd2.Settable(
                 "foreground_color",
                 str,
-                "Foreground color to use with echo command",
+                Text.assemble(
+                    "Foreground color to use with echo command ",
+                    "(Options: ",
+                    Text("Green", Style(color=Color.GREEN)),
+                    ", ",
+                    Text("Red", Style(color=Color.RED)),
+                    ", ",
+                    Text("Blue", Style(color=Color.BLUE)),
+                    ", ...)",
+                ),
                 self,
                 choices=fg_colors,
             )

tests/test_cmd2.py

@@ -18,6 +18,7 @@
 from prompt_toolkit.input import DummyInput, create_pipe_input
 from prompt_toolkit.output import DummyOutput
 from prompt_toolkit.shortcuts import PromptSession
+from rich.style import Style
 from rich.text import Text
 
 import cmd2
@@ -352,6 +353,31 @@ def test_set_with_choices(base_app) -> None:
     assert err[0].startswith("Error setting fake: invalid choice")
 
 
+def test_set_with_rich_description(base_app) -> None:
+    """Test with rich Text description."""
+    description = "Rich text description"
+    base_app.rich_settable = "old"
+    rich_settable = cmd2.Settable(
+        "rich_settable", type(base_app.rich_settable), Text(description, Style(color="red", bold=True)), base_app
+    )
+    base_app.add_settable(rich_settable)
+
+    # Try see list settables info
+    out, err = run_cmd(base_app, "set rich_settable")
+    assert not err
+    name, value, text = out[-1].strip().split(maxsplit=2)
+    assert name == "rich_settable"
+    assert value == "old"
+    assert text == description
+
+    # Try to set a valid value
+    out, err = run_cmd(base_app, "set rich_settable new")
+    assert base_app.last_result is True
+    assert not err
+    assert out[0].startswith("rich_settable")
+    assert out[0].endswith("─> 'new'")
+
+
 class OnChangeHookApp(cmd2.Cmd):
     def __init__(self, *args, **kwargs) -> None:
         super().__init__(*args, **kwargs)
@@ -4726,3 +4752,7 @@ def do_base(self, _: argparse.Namespace) -> None:
     root_parser = cast(cmd2.Cmd2ArgumentParser, app.command_parsers.get(app.do_base))
     subparsers_action = root_parser.get_subparsers_action()
     assert not subparsers_action._name_parser_map
+    subparsers_action = root_parser.get_subparsers_action()
+    assert not subparsers_action._name_parser_map
+    subparsers_action = root_parser.get_subparsers_action()
+    assert not subparsers_action._name_parser_map