options(feat[show_options]): Add public show_options() method

why: CHANGES documented Window.show_options() as replacement for
show_window_options(), but only private _show_options() existed.
what:
- Add show_options() public method to OptionsMixin as thin wrapper
- Update Window.show_window_options() deprecation to reference show_options()
- Add doctest examples for show_options()

Author: tony

src/libtmux/options.py

@@ -939,6 +939,52 @@ def _show_options(
 
         return t.cast("ExplodedComplexUntypedOptionsDict", output_exploded)
 
+    def show_options(
+        self,
+        global_: bool = False,
+        scope: OptionScope | _DefaultOptionScope | None = DEFAULT_OPTION_SCOPE,
+        include_hooks: bool | None = None,
+        include_inherited: bool | None = None,
+    ) -> ExplodedComplexUntypedOptionsDict:
+        """Return all options for the target.
+
+        Parameters
+        ----------
+        global_ : bool, optional
+            Pass ``-g`` flag for global options, default False.
+        scope : OptionScope | _DefaultOptionScope | None, optional
+            Option scope (Server/Session/Window/Pane), defaults to object's scope.
+        include_hooks : bool, optional
+            Include hook options (``-H`` flag).
+        include_inherited : bool, optional
+            Include inherited options (``-A`` flag).
+
+        Returns
+        -------
+        ExplodedComplexUntypedOptionsDict
+            Dictionary with all options, arrays exploded and values converted.
+
+        Raises
+        ------
+        :exc:`exc.OptionError`, :exc:`exc.UnknownOption`,
+        :exc:`exc.InvalidOption`, :exc:`exc.AmbiguousOption`
+
+        Examples
+        --------
+        >>> options = server.show_options()
+        >>> isinstance(options, dict)
+        True
+
+        >>> 'buffer-limit' in options
+        True
+        """
+        return self._show_options(
+            global_=global_,
+            scope=scope,
+            include_hooks=include_hooks,
+            include_inherited=include_inherited,
+        )
+
     def _show_option_raw(
         self,
         option: str,

src/libtmux/window.py

@@ -884,20 +884,20 @@ def set_window_option(
         return self.set_option(option=option, value=value)
 
     def show_window_options(self, g: bool | None = False) -> WindowOptionDict:
-        """Show options for tmux window. Deprecated by :meth:`Window._show_options()`.
+        """Show options for tmux window. Deprecated by :meth:`Window.show_options()`.
 
         .. deprecated:: 0.26
 
-           Deprecated by :meth:`Window._show_options()`.
+           Deprecated by :meth:`Window.show_options()`.
 
         """
         warnings.warn(
             "Window.show_window_options() is deprecated",
             category=DeprecationWarning,
             stacklevel=2,
         )
-        return self._show_options(
-            g=g,
+        return self.show_options(
+            global_=g or False,
             scope=OptionScope.Window,
         )