Window: Add show_option(), deprecate show_window_option()

Author: tony

src/libtmux/window.py

@@ -346,7 +346,7 @@ def set_option(
         self,
         option: str,
         value: t.Union[int, str],
-        format: t.Optional[bool] = None,
+        _format: t.Optional[bool] = None,
         unset: t.Optional[bool] = None,
         unset_panes: t.Optional[bool] = None,
         prevent_overwrite: t.Optional[bool] = None,
@@ -385,8 +385,8 @@ def set_option(
             assert isinstance(unset_panes, bool)
             flags.append("-U")
 
-        if format is not None and format:
-            assert isinstance(format, bool)
+        if _format is not None and _format:
+            assert isinstance(_format, bool)
             flags.append("-F")
 
         if prevent_overwrite is not None and prevent_overwrite:
@@ -419,11 +419,18 @@ def set_option(
         return self
 
     def show_window_options(self, g: t.Optional[bool] = False) -> "WindowOptionDict":
-        """Return dict of options for window.
+        """Show options for tmux window. Deprecated by :meth:`Window.show_options()`.
 
-        .. versionchanged:: 0.13.0
+        .. deprecated:: 0.26
+
+           Deprecated by :meth:`Window.show_options()`.
+
+        """
+        warnings.warn("Window.show_window_options() is deprecated", stacklevel=2)
+        return self.show_options(g=g)
 
-           ``option`` removed, use show_window_option to return an individual option.
+    def show_options(self, g: t.Optional[bool] = False) -> "WindowOptionDict":
+        """Return a dict of options for the window.
 
         Parameters
         ----------
@@ -462,6 +469,19 @@ def show_window_option(
         self,
         option: str,
         g: bool = False,
+    ) -> t.Optional[t.Union[str, int]]:
+        """Return option for target window. Deprecated by :meth:`Window.show_option()`.
+
+        .. deprecated:: 0.26
+
+           Deprecated by :meth:`Window.show_option()`.
+
+        """
+        warnings.warn("Window.show_window_option() is deprecated", stacklevel=2)
+        return self.show_option(option=option, g=g)
+
+    def show_option(
+        self, option: str, g: bool = False
     ) -> t.Optional[t.Union[str, int]]:
         """Return option value for the target window.