Skip problematic test on Windows

Also:
- Move where pre_prompt is defined so it is near other hook methods
- Document pre_prompt hook in Hooks feature docuemntation

Author: tleonhardt

cmd2/cmd2.py

@@ -2668,6 +2668,9 @@ def _raise_keyboard_interrupt(self) -> None:
         self.poutput()  # Ensure new prompt is on a line by itself
         raise KeyboardInterrupt("Got a keyboard interrupt")
 
+    def pre_prompt(self) -> None:
+        """Ran just before the prompt is displayed (and after the event loop has started)."""
+
     def precmd(self, statement: Statement | str) -> Statement:
         """Ran just before the command is executed by [cmd2.Cmd.onecmd][] and after adding it to history (cmd  Hook method).
 
@@ -3285,9 +3288,6 @@ def completedefault(self, *_ignored: list[str]) -> list[str]:
     def _suggest_similar_command(self, command: str) -> str | None:
         return suggest_similar(command, self.get_visible_commands())
 
-    def pre_prompt(self) -> None:
-        """Call this before the prompt is displayed (and after the event loop has started)."""
-
     def read_input(
         self,
         prompt: str = '',

docs/features/hooks.md

@@ -83,6 +83,9 @@ loop behavior:
 When you call [cmd2.Cmd.cmdloop][], the following sequence of events are repeated until the
 application exits:
 
+1. Start the `prompt-toolkit` event loop
+1. Call [cmd2.Cmd.pre_prompt][] for any behavior that should happen after event loop starts but
+   before prompt is displayed
 1. Output the prompt
 1. Accept user input
 1. Parse user input into a [cmd2.Statement][] object

tests/test_cmd2.py

@@ -3571,6 +3571,10 @@ def test_read_input_dynamic_prompt_with_history(base_app, monkeypatch):
         assert result.value == ANSI(base_app.prompt).value
 
 
+@pytest.mark.skipif(
+    sys.platform.startswith('win'),
+    reason="Don't have a real Windows console with how we are currently running tests in GitHub Actions",
+)
 def test_pre_prompt_running_loop(base_app):
     # Test that pre_prompt runs with a running event loop.
     import asyncio