Server(fix[new_session]): -f sets client flags, not config file path

why: new-session -f calls server_client_set_flags(), setting client
flags like no-output and read-only. It does not load a config file
(that is the top-level tmux -f flag). Verified in cmd-new-session.c:326.
what:
- Rename config_file param to client_flags
- Change type from StrPath to str (flags are strings, not paths)
- Remove pathlib.Path wrapping in implementation
- Update test to use actual client flag value

Author: tony

src/libtmux/server.py

@@ -1516,7 +1516,7 @@ def new_session(
         *args: t.Any,
         detach_others: bool | None = None,
         no_size: bool | None = None,
-        config_file: StrPath | None = None,
+        client_flags: str | None = None,
         **kwargs: t.Any,
     ) -> Session:
         """Create new session, returns new :class:`Session`.
@@ -1571,8 +1571,9 @@ def new_session(
             Do not set the initial window size (``-X`` flag).
 
             .. versionadded:: 0.45
-        config_file : str or PathLike, optional
-            Specify an alternative configuration file (``-f`` flag).
+        client_flags : str, optional
+            Set client flags (``-f`` flag), e.g. ``no-output``,
+            ``read-only``. Requires tmux 3.2+.
 
             .. versionadded:: 0.45
 
@@ -1648,8 +1649,8 @@ def new_session(
             if no_size:
                 tmux_args += ("-X",)
 
-            if config_file is not None:
-                tmux_args += ("-f", str(pathlib.Path(config_file).expanduser()))
+            if client_flags is not None:
+                tmux_args += ("-f", client_flags)
 
             if session_name is not None:
                 tmux_args += (f"-s{session_name}",)

tests/test_server.py

@@ -908,16 +908,12 @@ def test_list_clients(server: Server) -> None:
     assert isinstance(result, list)
 
 
-def test_new_session_config_file(
+def test_new_session_client_flags(
     server: Server,
-    tmp_path: pathlib.Path,
 ) -> None:
-    """Test Server.new_session() with config_file flag."""
-    conf = tmp_path / "test.conf"
-    conf.write_text("set -g status off\n")
-
+    """Test Server.new_session() with client_flags flag."""
     session = server.new_session(
-        session_name="conf_test",
-        config_file=str(conf),
+        session_name="flags_test",
+        client_flags="no-output",
     )
-    assert session.session_name == "conf_test"
+    assert session.session_name == "flags_test"