Drop support for tmux versions < 3.2 (#993)

Remove old tmux version references (< 3.2)

Clean up all references to tmux versions older than 3.2 now that the
minimum version has been bumped to tmux 3.2+ (via libtmux 0.48.0).

Documentation updates:
- docs(README) Update minimum tmux version to 3.2+
- docs(about) Update minimum tmux version to 3.2+
- docs(about_tmux) Update tmux version requirement to 3.2+
- docs(quickstart) Update minimum tmux version to 3.2+
- docs(quickstart) Python 3.7 -> 3.9
- docs(AGENTS) Update minimum tmux version to 3.2+
- docs(examples) Remove tmux 3.0 version note for environment variables
- docs(CHANGES) Note PR #993

Code cleanup:
- plugin(TMUX_MIN_VERSION) Update to 3.2
- builder! Remove tmux < 3.0 environment variable warning
- builder! Remove tmux 2.6 version check for terminal size
- cli(load) Remove outdated tmux 2.6 docstring note

Test cleanup:
- tests(test_load) Remove tmux 2.1 skip marker
- tests(test_builder) Remove tmux < 3.0 skip and delete obsolete test
- tests(test_builder) Remove tmux 2.3 conditionals
- tests(test_builder) Remove tmux 3.2a skip marker
- tests(test_builder) Remove tmux 2.9 skip markers and cleanup imports

Author: tony

AGENTS.md

@@ -121,4 +121,4 @@ windows:
 - **Doctest format**: Use narrative descriptions with blank lines between sections
 - **Complex examples**: Move to `tests/examples/<path>/test_<example>.py`
 - **Minimum Python**: 3.9+ (as per README)
-- **Minimum tmux**: 1.8+ (as per README)
+- **Minimum tmux**: 3.2+ (as per README)

CHANGES

@@ -35,7 +35,7 @@ _Future release notes will be placed here_
 
 ### Breaking changes
 
-#### Minimum tmux version bumped to 3.2+ (#992)
+#### Minimum tmux version bumped to 3.2+ (#992, #993)
 
 tmux versions below 3.2a are now disabled (via libtmux v0.49.0).
 

README.md

@@ -293,7 +293,7 @@ See donation options at <https://tony.sh/support.html>.
 
 # Project details
 
-- tmux support: 1.8+
+- tmux support: 3.2+
 - python support: >= 3.10, pypy, pypy3
 - Source: <https://github.com/tmux-python/tmuxp>
 - Docs: <https://tmuxp.git-pull.com>

docs/about.md

@@ -41,7 +41,7 @@ well tested and adopted.
 
 ### Missing
 
-**Version support** tmuxp only supports `tmux >= 1.8`. Teamocil and
+**Version support** tmuxp only supports `tmux >= 3.2`. Teamocil and
 tmuxinator may have support for earlier versions.
 
 ### Differences
@@ -64,7 +64,7 @@ format [^id4]. See {ref}`cli-freeze`.
 
 **JSON config** JSON config support. See {ref}`Examples`.
 
-**ORM-based API** via [libtmux] - Utilizes tmux >= 1.8's unique ID's for
+**ORM-based API** via [libtmux] - Utilizes tmux's unique IDs for
 panes, windows and sessions to create an object relational view of the tmux
 {class}`~libtmux.Server`, its {class}`~libtmux.Session`,
 {class}`~libtmux.Window`, and {class}`~libtmux.Pane`.

docs/about_tmux.md

@@ -222,9 +222,8 @@ For the freshest results on how to get tmux installed on your system,
 "How to install tmux on \<my distro>" will do, as directions change and
 are slightly different between distributions.
 
-This documentation is written for version **1.8**. It's important that
-you have the latest stable release of tmux. The latest stable version is
-viewable on the [tmux homepage](http://tmux.sourceforge.net/).
+tmuxp requires tmux **3.2 or newer**. The latest stable version is
+viewable on the [tmux homepage](https://github.com/tmux/tmux).
 
 **Mac OS X** users may install the latest stable version of tmux
 through [MacPorts](http://www.macports.org/),

docs/configuration/examples.md

@@ -266,8 +266,7 @@ tmuxp will set session, window and pane environment variables.
 
 ```{note}
 
-Setting environment variables for windows and panes requires tmuxp 1.19 or
-newer and tmux 3.0 or newer.
+Setting environment variables for windows and panes requires tmuxp 1.19 or newer.
 ```
 
 ````{tab} YAML

docs/quickstart.md

@@ -4,7 +4,7 @@
 
 ## Installation
 
-Ensure you have at least tmux **>= 1.8** and python **>= 3.7**.
+Ensure you have at least tmux **>= 3.2** and python **>= 3.9**.
 
 ```console
 $ pip install --user tmuxp

src/tmuxp/cli/load.py

@@ -275,27 +275,6 @@ def load_workspace(
     prompt to cleanup (``$ tmux kill-session``) the session on the user's
     behalf. An exception raised during this process means it's not easy to
     predict how broken the session is.
-
-    .. versionchanged:: tmux 2.6+
-
-        In tmux 2.6, the way layout and proportion's work when interfacing
-        with tmux in a detached state (outside of a client) changed. Since
-        tmuxp builds workspaces in a detached state, the WorkspaceBuilder isn't
-        able to rely on functionality requiring awarness of session geometry,
-        e.g. ``set-layout``.
-
-        Thankfully, tmux is able to defer commands to run after the user
-        performs certain actions, such as loading a client via
-        ``attach-session`` or ``switch-client``.
-
-        Upon client switch, ``client-session-changed`` is triggered [1]_.
-
-    References
-    ----------
-    .. [1] cmd-switch-client.c hook. GitHub repo for tmux.
-
-       https://github.com/tmux/tmux/blob/2.6/cmd-switch-client.c#L132.
-       Accessed April 8th, 2018.
     """
     # get the canonical path, eliminating any symlinks
     if isinstance(workspace_file, (str, os.PathLike)):

src/tmuxp/plugin.py

@@ -11,8 +11,8 @@
 from .__about__ import __version__
 from .exc import TmuxpPluginException
 
-#: Minimum version of tmux required to run libtmux
-TMUX_MIN_VERSION = "1.8"
+#: Minimum version of tmux required to run tmuxp
+TMUX_MIN_VERSION = "3.2"
 
 #: Most recent version of tmux supported
 TMUX_MAX_VERSION = None

src/tmuxp/workspace/builder.py

@@ -9,7 +9,6 @@
 import typing as t
 
 from libtmux._internal.query_list import ObjectDoesNotExist
-from libtmux.common import has_gte_version, has_lt_version
 from libtmux.pane import Pane
 from libtmux.server import Server
 from libtmux.session import Session
@@ -253,10 +252,7 @@ def build(self, session: Session | None = None, append: bool = False) -> None:
                     "start_directory"
                 ]
 
-            if (
-                has_gte_version("2.6")
-                and os.getenv("TMUXP_DETECT_TERMINAL_SIZE", "1") == "1"
-            ):
+            if os.getenv("TMUXP_DETECT_TERMINAL_SIZE", "1") == "1":
                 terminal_size = shutil.get_terminal_size(
                     fallback=(get_default_columns(), get_default_rows()),
                 )
@@ -406,25 +402,6 @@ def iter_create_windows(
                 pass
 
             environment = panes[0].get("environment", window_config.get("environment"))
-            if environment and has_lt_version("3.0"):
-                # Falling back to use the environment of the first pane for the window
-                # creation is nice but yields misleading error messages.
-                pane_env = panes[0].get("environment")
-                win_env = window_config.get("environment")
-                if pane_env and win_env:
-                    target = "panes and windows"
-                elif pane_env:
-                    target = "panes"
-                else:
-                    target = "windows"
-                logger.warning(
-                    (
-                        "Cannot set environment for new %s. "
-                        "You need tmux 3.0 or newer for this."
-                    ),
-                    target,
-                )
-                environment = None
 
             window = session.new_window(
                 window_name=window_name,
@@ -513,16 +490,6 @@ def get_pane_shell(
                     "environment",
                     window_config.get("environment"),
                 )
-                if environment and has_lt_version("3.0"):
-                    # Just issue a warning when the environment comes from the pane
-                    # configuration as a warning for the window was already issued when
-                    # the window was created.
-                    if pane_config.get("environment"):
-                        logger.warning(
-                            "Cannot set environment for new panes. "
-                            "You need tmux 3.0 or newer for this.",
-                        )
-                    environment = None
 
                 assert pane is not None