Options,Env(feat): add quiet/values-only to show_options, format/hidden to set_environment

why: show-options supports -q (quiet) and -v (values only) flags, and
set-environment supports -F (format expansion) and -h (hidden) flags that
were not exposed in the Python API.
what:
- Add quiet (-q) and values_only (-v) to _show_options_raw()
- Add expand_format (-F) and hidden (-h) to set_environment()
- Add tests for quiet show_options, hidden env vars, and format expansion

Author: tony

src/libtmux/common.py

@@ -60,7 +60,14 @@ class EnvironmentMixin:
     def __init__(self, add_option: str | None = None) -> None:
         self._add_option = add_option
 
-    def set_environment(self, name: str, value: str) -> None:
+    def set_environment(
+        self,
+        name: str,
+        value: str,
+        *,
+        expand_format: bool | None = None,
+        hidden: bool | None = None,
+    ) -> None:
         """Set environment ``$ tmux set-environment <name> <value>``.
 
         Parameters
@@ -69,6 +76,14 @@ def set_environment(self, name: str, value: str) -> None:
             The environment variable name, e.g. 'PATH'.
         value : str
             Environment value.
+        expand_format : bool, optional
+            Expand tmux format strings in the value (``-F`` flag).
+
+            .. versionadded:: 0.45
+        hidden : bool, optional
+            Mark the variable as hidden (``-h`` flag).
+
+            .. versionadded:: 0.45
 
         Raises
         ------
@@ -79,6 +94,12 @@ def set_environment(self, name: str, value: str) -> None:
         if self._add_option:
             args += [self._add_option]
 
+        if expand_format:
+            args += ["-F"]
+
+        if hidden:
+            args += ["-h"]
+
         args += [name, value]
 
         cmd = self.cmd(*args)

src/libtmux/options.py

@@ -807,6 +807,8 @@ def _show_options_raw(
         scope: OptionScope | _DefaultOptionScope | None = DEFAULT_OPTION_SCOPE,
         include_hooks: bool | None = None,
         include_inherited: bool | None = None,
+        quiet: bool | None = None,
+        values_only: bool | None = None,
     ) -> tmux_cmd:
         """Return a dict of options for the target.
 
@@ -867,6 +869,12 @@ def _show_options_raw(
         if include_hooks is not None and include_hooks:
             flags += ("-H",)
 
+        if quiet is not None and quiet:
+            flags += ("-q",)
+
+        if values_only is not None and values_only:
+            flags += ("-v",)
+
         return self.cmd("show-options", *flags)
 
     def _show_options_dict(

tests/test_options.py

@@ -1494,3 +1494,38 @@ def test_explode_arrays_preserves_inherited_marker(
         assert array_value[idx] == expected_val, (
             f"Value at index {idx}: expected '{expected_val}', got '{array_value[idx]}'"
         )
+
+
+def test_show_options_quiet(server: Server) -> None:
+    """Test _show_options_raw with quiet flag suppresses errors."""
+    from libtmux.constants import OptionScope
+
+    # Query with quiet — should not raise even with unusual options
+    result = server._show_options_raw(
+        scope=OptionScope.Server,
+        quiet=True,
+    )
+    assert isinstance(result.stdout, list)
+
+
+def test_set_environment_hidden(session: Session) -> None:
+    """Test set_environment with hidden flag."""
+    session.set_environment("HIDDEN_TEST_VAR", "secret", hidden=True)
+
+    # Normal show_environment should NOT show hidden vars
+    env = session.show_environment()
+    assert "HIDDEN_TEST_VAR" not in env
+
+
+def test_set_environment_expand_format(session: Session) -> None:
+    """Test set_environment with expand_format flag."""
+    session.set_environment(
+        "FORMAT_TEST_VAR",
+        "#{session_name}",
+        expand_format=True,
+    )
+
+    env = session.show_environment()
+    # The value should have been expanded (not the raw format string)
+    assert "FORMAT_TEST_VAR" in env
+    assert env["FORMAT_TEST_VAR"] != "#{session_name}"