refactor!(options): Move handle_options_error -> options

Author: tony

src/libtmux/common.py

@@ -464,42 +464,6 @@ def session_check_name(session_name: str | None) -> None:
         raise exc.BadSessionName(reason="contains colons", session_name=session_name)
 
 
-def handle_option_error(error: str) -> type[exc.OptionError]:
-    """Raise exception if error in option command found.
-
-    In tmux 3.0, show-option and show-window-option return invalid option instead of
-    unknown option. See https://github.com/tmux/tmux/blob/3.0/cmd-show-options.c.
-
-    In tmux >2.4, there are 3 different types of option errors:
-
-    - unknown option
-    - invalid option
-    - ambiguous option
-
-    In tmux <2.4, unknown option was the only option.
-
-    All errors raised will have the base error of :exc:`exc.OptionError`. So to
-    catch any option error, use ``except exc.OptionError``.
-
-    Parameters
-    ----------
-    error : str
-        Error response from subprocess call.
-
-    Raises
-    ------
-    :exc:`exc.OptionError`, :exc:`exc.UnknownOption`, :exc:`exc.InvalidOption`,
-    :exc:`exc.AmbiguousOption`
-    """
-    if "unknown option" in error:
-        raise exc.UnknownOption(error)
-    if "invalid option" in error:
-        raise exc.InvalidOption(error)
-    if "ambiguous option" in error:
-        raise exc.AmbiguousOption(error)
-    raise exc.OptionError(error)  # Raise generic option error
-
-
 def get_libtmux_version() -> LooseVersion:
     """Return libtmux version is a PEP386 compliant format.
 

src/libtmux/options.py

@@ -0,0 +1,45 @@
+"""Helpers for tmux options."""
+
+from __future__ import annotations
+
+import logging
+
+from . import exc
+
+logger = logging.getLogger(__name__)
+
+
+def handle_option_error(error: str) -> type[exc.OptionError]:
+    """Raise exception if error in option command found.
+
+    In tmux 3.0, show-option and show-window-option return invalid option instead of
+    unknown option. See https://github.com/tmux/tmux/blob/3.0/cmd-show-options.c.
+
+    In tmux >2.4, there are 3 different types of option errors:
+
+    - unknown option
+    - invalid option
+    - ambiguous option
+
+    In tmux <2.4, unknown option was the only option.
+
+    All errors raised will have the base error of :exc:`exc.OptionError`. So to
+    catch any option error, use ``except exc.OptionError``.
+
+    Parameters
+    ----------
+    error : str
+        Error response from subprocess call.
+
+    Raises
+    ------
+    :exc:`exc.OptionError`, :exc:`exc.UnknownOption`, :exc:`exc.InvalidOption`,
+    :exc:`exc.AmbiguousOption`
+    """
+    if "unknown option" in error:
+        raise exc.UnknownOption(error)
+    if "invalid option" in error:
+        raise exc.InvalidOption(error)
+    if "ambiguous option" in error:
+        raise exc.AmbiguousOption(error)
+    raise exc.OptionError(error)  # Raise generic option error

src/libtmux/session.py

@@ -24,11 +24,11 @@
 from .common import (
     EnvironmentMixin,
     WindowDict,
-    handle_option_error,
     has_gte_version,
     has_version,
     session_check_name,
 )
+from .options import handle_option_error
 
 if t.TYPE_CHECKING:
     from libtmux.common import tmux_cmd

src/libtmux/window.py

@@ -27,9 +27,10 @@
 from libtmux.pane import Pane
 
 from . import exc
-from .common import PaneDict, WindowOptionDict, handle_option_error
+from .options import handle_option_error
 
 if t.TYPE_CHECKING:
+    from .common import PaneDict, WindowOptionDict
     from .server import Server
     from .session import Session