Server(fix[new_session]): Harden error handling and TMUX env restoration#628
Draft
tony wants to merge 1 commit into
Draft
Server(fix[new_session]): Harden error handling and TMUX env restoration#628tony wants to merge 1 commit into
tony wants to merge 1 commit into
Conversation
Codecov Report✅ All modified and coverable lines are covered by tests. Additional details and impacted files@@ Coverage Diff @@
## master #628 +/- ##
==========================================
+ Coverage 47.02% 47.25% +0.23%
==========================================
Files 23 23
Lines 3296 3299 +3
Branches 709 710 +1
==========================================
+ Hits 1550 1559 +9
+ Misses 1384 1379 -5
+ Partials 362 361 -1 ☔ View full report in Codecov by Sentry. 🚀 New features to boost your workflow:
|
tony
force-pushed
the
fix/session-env-restoration
branch
from
a74c602 to
4012283
Compare
… empty why: Server.new_session reads session_stdout via proc.stdout[0] without checking that proc.stdout has any elements. If tmux returns empty stdout (without writing to stderr — corrupt pipe, kernel-level signal mid-write, mocked transport), this raises an unhelpful IndexError instead of a branded LibTmuxException. The TMUX env restoration was already wrapped in try/finally on master, but the empty-stdout guard was missing. what: - add 'if not proc.stdout: raise LibTmuxException' check before indexing proc.stdout[0] - add tests for empty stdout, TMUX env restoration on cmd-side errors, and TMUX env restoration on setup-phase errors (to verify the existing try/finally covers arg-building, not just the cmd() call) - tests use monkeypatch per CLAUDE.md (cannot trigger empty stdout from a healthy tmux server otherwise)
tony
force-pushed
the
fix/session-env-restoration
branch
from
4012283 to
4b86328
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
new_session()deletesos.environ["TMUX"]before calling tmux but only restores it on the success path — any exception permanently leaks the deletion. This wraps all post-deletion code intry/finally.proc.stdout[0]raises an unhelpfulIndexErrorif tmux produces no output. This adds an explicit guard with a descriptiveLibTmuxException.Split out from #576 — hardening that's independent of the race condition fix itself.
Changes
src/libtmux/server.py:del os.environ["TMUX"]intry/finallyto ensure restoration on any exception (including setup-phase errors likepathlib.Path.expanduser())proc.stdoutwith descriptiveLibTmuxExceptiontests/test_server.py:test_new_session_empty_stdout— verifies error on empty stdouttest_new_session_restores_tmux_env_on_error— verifies TMUX restored after cmd errortest_new_session_restores_tmux_env_on_setup_error— verifies TMUX restored after setup-phase errorTest plan
uv run pytest— 875 passed, 1 skippeduv run ruff check .— all checks passeduv run mypy src tests— no issues