Skip to content

Conversation

@tony
Copy link
Member

@tony tony commented Nov 30, 2025

Remove old tmux version references (< 3.2)

Summary

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 in tmuxp v1.57.0).

This PR removes:

  • Dead code paths that checked for tmux < 3.0 or < 2.6
  • Test skip markers for older tmux versions
  • Outdated documentation references

Changes

Code cleanup (~35 lines removed)

  • builder.py: Remove has_lt_version("3.0") blocks for environment
    variable warnings (feature always available now)
  • builder.py: Remove has_gte_version("2.6") check for terminal size
    detection (always true now)
  • cli/load.py: Remove outdated docstring about tmux 2.6 layout changes
  • plugin.py: Update TMUX_MIN_VERSION constant from "1.8" to "3.2"

Test cleanup (~70 lines removed)

  • Remove skip markers for tmux < 2.1, < 2.3, < 2.9, < 3.0, < 3.2a
  • Delete obsolete test_environment_variables_warns_prior_to_tmux_3_0 test
  • Remove conditional pane-border-format setup (tmux 2.3 feature)
  • Clean up unused has_lt_version/has_gte_version imports

Documentation updates

  • README.md: 1.8+ -> 3.2+
  • docs/about.md: >= 1.8 -> >= 3.2
  • docs/about_tmux.md: Update version requirement, fix tmux homepage URL
  • docs/quickstart.md: 1.8 -> 3.2
  • docs/configuration/examples.md: Remove tmux 3.0 note for env vars
  • AGENTS.md (+ CLAUDE.md symlink): 1.8+ -> 3.2+

See also

tony added 10 commits November 29, 2025 18:09
Reflects the minimum version bump in v1.57.0 via libtmux 0.48.0.
- Update minimum version requirement from 1.8 to 3.2
- Remove outdated version reference for unique IDs feature (available since 1.8)
- Update from "written for version 1.8" to "requires tmux 3.2 or newer"
- Update tmux homepage link to GitHub (sourceforge is outdated)
Update the plugin system's minimum tmux version constant from 1.8 to 3.2.
Also fix comment typo ("libtmux" -> "tmuxp").
Remove dead code that warned users about environment variable support
requiring tmux 3.0+. Since tmux 3.2+ is now the minimum version,
environment variables are always supported.

- Remove warning blocks for windows and panes
- Remove unused has_lt_version import
The terminal size detection feature was gated behind a tmux 2.6+ check.
Since tmux 3.2+ is now the minimum version, this check is always true.

- Simplify condition to only check TMUXP_DETECT_TERMINAL_SIZE env var
- Remove unused has_gte_version import
Remove historical documentation about tmux 2.6 layout behavior changes.
This is no longer relevant as a "versionchanged" note since tmux 3.2+
is now the minimum version.
Remove skip marker for test_load_workspace_name_match_regression_252.
This test was skipped for tmux < 2.1, which is no longer relevant now
that tmux 3.2+ is the minimum version.
- Remove skip marker from test_environment_variables (was for tmux < 3.0)
- Delete test_environment_variables_warns_prior_to_tmux_3_0 entirely
  (tested warning behavior that no longer exists)
Remove conditional pane-border-format setup and assertion. The feature
is always available since tmux 3.2+ is now the minimum version.
@tony tony force-pushed the drop-old-tmux-versions-pt2 branch from 12a3054 to 6c727f0 Compare November 30, 2025 00:09
Remove skip marker from test_start_directory_sets_session_path.
This test uses a format introduced in tmux 3.2a, which is now the
minimum version.
@codecov
Copy link

codecov bot commented Nov 30, 2025

Codecov Report

❌ Patch coverage is 50.00000% with 1 line in your changes missing coverage. Please review.
✅ Project coverage is 72.92%. Comparing base (4caac8e) to head (818b24a).
⚠️ Report is 18 commits behind head on master.

Files with missing lines Patch % Lines
src/tmuxp/workspace/builder.py 0.00% 0 Missing and 1 partial ⚠️
Additional details and impacted files
@@            Coverage Diff             @@
##           master     #993      +/-   ##
==========================================
+ Coverage   72.38%   72.92%   +0.53%     
==========================================
  Files          26       26              
  Lines        1854     1839      -15     
  Branches      352      347       -5     
==========================================
- Hits         1342     1341       -1     
+ Misses        407      395      -12     
+ Partials      105      103       -2     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

tony added 5 commits November 29, 2025 18:12
- Remove skip markers from test_layout_main_horizontal and
  test_issue_800_default_size_many_windows
- Remove unused has_lt_version import

These features are always available since tmux 3.2+ is now the
minimum version.
Update installation requirements to reflect the new minimum tmux version.
Environment variable support is always available now that tmux 3.2+ is
the minimum version.
@tony tony marked this pull request as ready for review November 30, 2025 11:48
@tony tony merged commit bcefd68 into master Nov 30, 2025
14 checks passed
@tony tony deleted the drop-old-tmux-versions-pt2 branch November 30, 2025 11:54
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants