Updated CHANGELOG.md

Also improved some docstring whitespace in examples/async_call.py

Author: tleonhardt

CHANGELOG.md

@@ -21,6 +21,13 @@ shell, and the option for a persistent bottom bar that can display realtime stat
       each platform and provided utility functions related to `readline`
     - Added a dependency on `prompt-toolkit` and a new `cmd2.pt_utils` module with supporting
       utilities
+    - Async specific: `prompt-toolkit` starts its own `asyncio` event loop in every `cmd2`
+      application
+- Enhancements
+    - Optional persistent **bottom toolbar** capable of displaying realtime status information, see
+      the `include_bottom_toolbar` optional argument to the initializer for `cmd2.Cmd` and the
+      `cmd2.Cmd2._bottom_toolbar` method that can be overridden as well as the updated
+      `getting_started.py` example
 
 ## 3.1.0 (December 25, 2025)
 

examples/async_call.py

@@ -12,9 +12,7 @@
 
 
 def run_async(coro) -> concurrent.futures.Future:
-    """
-    Await a coroutine from a synchronous function/method.
-    """
+    """Await a coroutine from a synchronous function/method."""
 
     global _event_loop  # noqa: PLW0603
 
@@ -33,22 +31,21 @@ def run_async(coro) -> concurrent.futures.Future:
 
 
 async def async_wait(duration: float) -> float:
-    """
-    Example async function that is called from a synchronous cmd2 command
-    """
+    """Example async function that is called from a synchronous cmd2 command"""
     await asyncio.sleep(duration)
     return duration
 
 
 class AsyncCallExample(cmd2.Cmd):
-    """
-    A simple cmd2 application.
+    """A simple cmd2 application.
+
     Demonstrates how to run an async function from a cmd2 command.
     """
 
     def do_async_wait(self, _: str) -> None:
-        """
-        Waits asynchronously.  Example cmd2 command that calls an async function.
+        """Waits asynchronously.
+
+        Example cmd2 command that calls an async function.
         """
 
         waitable = run_async(async_wait(0.1))
@@ -59,16 +56,15 @@ def do_async_wait(self, _: str) -> None:
         return
 
     def do_hello_world(self, _: str) -> None:
-        """
-        Prints a simple greeting.  Just a typical (synchronous) cmd2 command
+        """Prints a simple greeting.
+
+        Just a typical (synchronous) cmd2 command
         """
         self.poutput('Hello World')
 
 
 def main() -> int:
-    """
-    Main entry point for the example.
-    """
+    """Main entry point for the example."""
     app = AsyncCallExample()
     app.set_window_title("Call to an Async Function Test")
     return app.cmdloop()