feat(Server.new_session): Support '-'

Author: tony

src/libtmux/server.py

@@ -29,6 +29,11 @@
     session_check_name,
 )
 
+if t.TYPE_CHECKING:
+    from typing_extensions import Literal, TypeAlias
+
+    DashLiteral: TypeAlias = Literal["-"]
+
 logger = logging.getLogger(__name__)
 
 
@@ -351,8 +356,8 @@ def new_session(
         start_directory: t.Optional[str] = None,
         window_name: t.Optional[str] = None,
         window_command: t.Optional[str] = None,
-        x: t.Optional[int] = None,
-        y: t.Optional[int] = None,
+        x: t.Optional[t.Union[int, "DashLiteral"]] = None,
+        y: t.Optional[t.Union[int, "DashLiteral"]] = None,
         *args: t.Any,
         **kwargs: t.Any,
     ) -> Session:
@@ -395,10 +400,10 @@ def new_session(
             when the command exits. NOTE: When this command exits the window
             will close.  This feature is useful for long-running processes
             where the closing of the window upon completion is desired.
-        x : int, optional
+        x : [int, str], optional
             Force the specified width instead of the tmux default for a
             dettached session
-        y : int, optional
+        y : [int, str], optional
             Force the specified height instead of the tmux default for a
             dettached session
 

tests/test_server.py

@@ -143,6 +143,17 @@ def test_new_session_width_height(server: Server) -> None:
     assert pane.display_message("#{window_width}", get_text=True)[0] == "32"
     assert pane.display_message("#{window_height}", get_text=True)[0] == "32"
 
+    if has_gte_version("3.1"):
+        my_second_session = server.new_session(
+            "test_new_session_width_height_latest",
+            window_command=cmd,
+            x="-",
+            y="-",
+        )
+        pane_2 = my_second_session.windows[0].panes[0]
+        assert pane_2.display_message("#{window_height}", get_text=True)[0] == "32"
+        assert pane_2.display_message("#{window_width}", get_text=True)[0] == "32"
+
 
 def test_no_server_sessions() -> None:
     server = Server(socket_name="test_attached_session_no_server")