rename prompt_utils.py to interactive_utils.py

The reason this is clearer is that prompt_utils.py is not related to
prompt_toolkit, nor the REPL prompt format string.

Author: rolandwalker

AGENTS.md

@@ -31,9 +31,9 @@ A command line client for MySQL with auto-completion and syntax highlighting.
 ├── mycli/packages/completion_engine.py   # implementation of completion suggestions
 ├── mycli/packages/filepaths.py           # utilities for files, including completion suggestions
 ├── mycli/packages/hybrid_redirection.py  # implementation of shell-style redirects
+├── mycli/packages/interactive_utils.py   # utilities for confirming on destructive statements
 ├── mycli/packages/paramiko_stub/         # stub in case the Paramiko library is not installed
 ├── mycli/packages/sql_utils.py           # utilities for parsing SQL statements
-├── mycli/packages/prompt_utils.py        # utilities for confirming on destructive statements
 ├── mycli/packages/ptoolkit/              # extends prompt_toolkit
 ├── mycli/packages/shortcuts.py           # utilities for keyboard shortcuts
 ├── mycli/packages/special/               # implementation of mycli special commands

changelog.md

@@ -46,6 +46,7 @@ Internal
 * Move SQL utilities to a new `sql_utils.py`.
 * Move CLI utilities to a new `cli_utils.py`.
 * Move keybinding utilities to a new `key_binding_utils.py`.
+* Move interactive utilities to `interactive_utils.py`.
 
 
 1.67.1 (2026/03/28)

mycli/main.py

@@ -75,7 +75,7 @@
 from mycli.packages import special
 from mycli.packages.cli_utils import filtered_sys_argv, is_valid_connection_scheme
 from mycli.packages.filepaths import dir_path_exists, guess_socket_location
-from mycli.packages.prompt_utils import confirm_destructive_query
+from mycli.packages.interactive_utils import confirm_destructive_query
 from mycli.packages.special.favoritequeries import FavoriteQueries
 from mycli.packages.special.main import ArgType
 from mycli.packages.sqlresult import SQLResult

mycli/main_modes/batch.py

@@ -12,7 +12,7 @@
 import pymysql
 
 from mycli.packages.batch_utils import statements_from_filehandle
-from mycli.packages.prompt_utils import confirm_destructive_query
+from mycli.packages.interactive_utils import confirm_destructive_query
 from mycli.packages.sql_utils import is_destructive
 
 if TYPE_CHECKING:

mycli/main_modes/repl.py

@@ -47,11 +47,11 @@
 from mycli.packages import special
 from mycli.packages.filepaths import dir_path_exists
 from mycli.packages.hybrid_redirection import get_redirect_components, is_redirect_command
+from mycli.packages.interactive_utils import confirm, confirm_destructive_query
 from mycli.packages.key_binding_utils import (
     handle_clip_command,
     handle_editor_command,
 )
-from mycli.packages.prompt_utils import confirm, confirm_destructive_query
 from mycli.packages.ptoolkit.history import FileHistoryWithTimestamp
 from mycli.packages.special.utils import format_uptime, get_ssl_version, get_uptime, get_warning_count
 from mycli.packages.sql_utils import (

mycli/packages/prompt_utils.py mycli/packages/interactive_utils.pymycli/packages/prompt_utils.py renamed to mycli/packages/interactive_utils.py

@@ -17,7 +17,7 @@
 import sqlparse
 
 from mycli.compat import WIN
-from mycli.packages.prompt_utils import confirm_destructive_query
+from mycli.packages.interactive_utils import confirm_destructive_query
 from mycli.packages.special.delimitercommand import DelimiterCommand
 from mycli.packages.special.favoritequeries import FavoriteQueries
 from mycli.packages.special.main import COMMANDS as SPECIAL_COMMANDS

mycli/packages/special/iocommands.py

@@ -3,11 +3,11 @@
 import click
 import pytest
 
-from mycli.packages import prompt_utils
+from mycli.packages import interactive_utils
 
 
 def test_confirm_bool_param_type_converts_bool_and_strings() -> None:
-    boolean_type = prompt_utils.ConfirmBoolParamType()
+    boolean_type = interactive_utils.ConfirmBoolParamType()
 
     assert boolean_type.convert(True, None, None) is True
     assert boolean_type.convert(False, None, None) is False
@@ -19,7 +19,7 @@ def test_confirm_bool_param_type_converts_bool_and_strings() -> None:
 
 
 def test_confirm_bool_param_type_rejects_invalid_string() -> None:
-    boolean_type = prompt_utils.ConfirmBoolParamType()
+    boolean_type = interactive_utils.ConfirmBoolParamType()
 
     with pytest.raises(click.BadParameter, match='maybe is not a valid boolean'):
         boolean_type.convert('maybe', None, None)
@@ -38,13 +38,13 @@ def fake_is_destructive(keywords: list[str], query: str) -> bool:
         destructive_calls.append((keywords, query))
         return False
 
-    monkeypatch.setattr(prompt_utils, 'is_destructive', fake_is_destructive)
-    monkeypatch.setattr(prompt_utils, 'prompt', fake_prompt)
-    monkeypatch.setattr(prompt_utils.sys, 'stdin', SimpleNamespace(isatty=lambda: True))
+    monkeypatch.setattr(interactive_utils, 'is_destructive', fake_is_destructive)
+    monkeypatch.setattr(interactive_utils, 'prompt', fake_prompt)
+    monkeypatch.setattr(interactive_utils.sys, 'stdin', SimpleNamespace(isatty=lambda: True))
 
     keywords = ['drop']
     query = 'select 1;'
-    assert prompt_utils.confirm_destructive_query(keywords, query) is None
+    assert interactive_utils.confirm_destructive_query(keywords, query) is None
     assert destructive_calls == [(keywords, query)]
     assert prompt_called is False
 
@@ -57,13 +57,13 @@ def fake_prompt(*args: object, **kwargs: object) -> bool:
         prompt_called = True
         return True
 
-    monkeypatch.setattr(prompt_utils, 'is_destructive', lambda keywords, query: True)
-    monkeypatch.setattr(prompt_utils, 'prompt', fake_prompt)
-    monkeypatch.setattr(prompt_utils.sys, 'stdin', SimpleNamespace(isatty=lambda: False))
+    monkeypatch.setattr(interactive_utils, 'is_destructive', lambda keywords, query: True)
+    monkeypatch.setattr(interactive_utils, 'prompt', fake_prompt)
+    monkeypatch.setattr(interactive_utils.sys, 'stdin', SimpleNamespace(isatty=lambda: False))
 
     keywords = ['drop']
     sql = 'drop database foo;'
-    assert prompt_utils.confirm_destructive_query(keywords, sql) is None
+    assert interactive_utils.confirm_destructive_query(keywords, sql) is None
     assert prompt_called is False
 
 
@@ -79,20 +79,20 @@ def fake_is_destructive(keywords: list[str], query: str) -> bool:
         destructive_calls.append((keywords, query))
         return True
 
-    monkeypatch.setattr(prompt_utils, 'is_destructive', fake_is_destructive)
-    monkeypatch.setattr(prompt_utils, 'prompt', fake_prompt)
-    monkeypatch.setattr(prompt_utils.sys, 'stdin', SimpleNamespace(isatty=lambda: True))
+    monkeypatch.setattr(interactive_utils, 'is_destructive', fake_is_destructive)
+    monkeypatch.setattr(interactive_utils, 'prompt', fake_prompt)
+    monkeypatch.setattr(interactive_utils.sys, 'stdin', SimpleNamespace(isatty=lambda: True))
 
     keywords = ['drop']
     query = 'drop database foo;'
-    result = prompt_utils.confirm_destructive_query(keywords, query)
+    result = interactive_utils.confirm_destructive_query(keywords, query)
 
     assert result is True
     assert destructive_calls == [(keywords, query)]
     assert prompt_calls == [
         (
             ("You're about to run a destructive command.\nDo you want to proceed? (y/n)",),
-            {'type': prompt_utils.BOOLEAN_TYPE},
+            {'type': interactive_utils.BOOLEAN_TYPE},
         )
     ]
 
@@ -109,18 +109,18 @@ def fake_is_destructive(keywords: list[str], query: str) -> bool:
         destructive_calls.append((keywords, query))
         return True
 
-    monkeypatch.setattr(prompt_utils, 'is_destructive', fake_is_destructive)
-    monkeypatch.setattr(prompt_utils, 'prompt', fake_prompt)
-    monkeypatch.setattr(prompt_utils.sys, 'stdin', SimpleNamespace(isatty=lambda: True))
+    monkeypatch.setattr(interactive_utils, 'is_destructive', fake_is_destructive)
+    monkeypatch.setattr(interactive_utils, 'prompt', fake_prompt)
+    monkeypatch.setattr(interactive_utils.sys, 'stdin', SimpleNamespace(isatty=lambda: True))
 
     keywords = ['drop']
     query = 'drop database foo;'
-    assert prompt_utils.confirm_destructive_query(keywords, query) is False
+    assert interactive_utils.confirm_destructive_query(keywords, query) is False
     assert destructive_calls == [(keywords, query)]
     assert prompt_calls == [
         (
             ("You're about to run a destructive command.\nDo you want to proceed? (y/n)",),
-            {'type': prompt_utils.BOOLEAN_TYPE},
+            {'type': interactive_utils.BOOLEAN_TYPE},
         )
     ]
 
@@ -131,7 +131,7 @@ def fake_confirm(*args: object, **kwargs: object) -> bool:
 
     monkeypatch.setattr(click, 'confirm', fake_confirm)
 
-    assert prompt_utils.confirm('continue?') is False
+    assert interactive_utils.confirm('continue?') is False
 
 
 def test_confirm_delegates_to_click_confirm(monkeypatch: pytest.MonkeyPatch) -> None:
@@ -143,7 +143,7 @@ def fake_confirm(*args: object, **kwargs: object) -> bool:
 
     monkeypatch.setattr(click, 'confirm', fake_confirm)
 
-    assert prompt_utils.confirm('continue?', default=True) is True
+    assert interactive_utils.confirm('continue?', default=True) is True
     assert calls == [(('continue?',), {'default': True})]
 
 
@@ -153,7 +153,7 @@ def fake_prompt(*args: object, **kwargs: object) -> bool:
 
     monkeypatch.setattr(click, 'prompt', fake_prompt)
 
-    assert prompt_utils.prompt('continue?') is False
+    assert interactive_utils.prompt('continue?') is False
 
 
 def test_prompt_delegates_to_click_prompt(monkeypatch: pytest.MonkeyPatch) -> None:
@@ -165,5 +165,5 @@ def fake_prompt(*args: object, **kwargs: object) -> bool:
 
     monkeypatch.setattr(click, 'prompt', fake_prompt)
 
-    assert prompt_utils.prompt('continue?', type=prompt_utils.BOOLEAN_TYPE) is True
-    assert calls == [(('continue?',), {'type': prompt_utils.BOOLEAN_TYPE})]
+    assert interactive_utils.prompt('continue?', type=interactive_utils.BOOLEAN_TYPE) is True
+    assert calls == [(('continue?',), {'type': interactive_utils.BOOLEAN_TYPE})]