Deprecate legacy APIs (raise DeprecatedError)

[tony]

Convert deprecated APIs to raise DeprecatedError instead of DeprecationWarning
for legacy session/window/pane helpers, dict-style access, and old method/property
names deprecated in versions 0.16-0.33.

Breaking Changes

• Legacy APIs now raise DeprecatedError (hard error) instead of emitting warnings
• Affected: kill_server(), attach_session(), kill_session(), split_window(),
  select_window(), kill_window(), resize_pane(), select_pane(), dict access,
  where(), find_where(), get_by_id(), attached_window, attached_pane,
  children property, and more

Soft Warnings (Continuing)

• g parameter on options/hooks methods (use global_ instead)
• set_window_option(), show_window_option(), show_window_options() (0.50.0)

Changes

• exc.py: Add DeprecatedError exception class with structured messages
• server.py: Convert server-level deprecated methods to raise errors
• session.py: Convert session-level deprecated methods to raise errors
• window.py: Convert window-level deprecated methods to raise errors
• pane.py: Convert pane-level deprecated methods to raise errors
• options.py: Keep g parameter as soft warning, update internal calls
• CHANGES: Document breaking changes with deprecation table
• MIGRATION: Add comprehensive deprecation reference tables
• tests/: Update all tests to expect DeprecatedError or use new APIs

[codecov]

Codecov Report

❌ Patch coverage is 92.45283% with 4 lines in your changes missing coverage. Please review.
✅ Project coverage is 45.34%. Comparing base (d6a8838) to head (d87f185).

Files with missing lines	Patch %	Lines
src/libtmux/exc.py	50.00%	2 Missing ⚠️
src/libtmux/options.py	50.00%	2 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##           master     #611      +/-   ##
==========================================
+ Coverage   44.46%   45.34%   +0.88%     
==========================================
  Files          22       22              
  Lines        2305     2236      -69     
  Branches      362      354       -8     
==========================================
- Hits         1025     1014      -11     
+ Misses       1133     1079      -54     
+ Partials      147      143       -4     

☔ 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]

Code review

Found 1 issue:

1. Version inconsistency for get_by_id() deprecation in MIGRATION file

The MIGRATION file documents three different versions for the same deprecation:

• "Parameter Changes" table (lines 60-62): 0.26.0 for Server.get_by_id(), Session.get_by_id(), Window.get_by_id()
• "Query/Filter API Changes" table (lines 71, 75, 79): 0.17.0 for the same methods
• Actual code and docstrings: 0.16.0 (e.g., .. deprecated:: 0.16 in docstrings)

The code version 0.16.0 appears to be correct based on docstrings. The MIGRATION tables should be updated for consistency.

libtmux/MIGRATION

Lines 60 to 62 in 2a4771c

	| `Server.get_by_id()` | `id` | `session_id` | 0.26.0 (2024-02-06) |
	| `Session.get_by_id()` | `id` | `window_id` | 0.26.0 (2024-02-06) |
	| `Window.get_by_id()` | `id` | `pane_id` | 0.26.0 (2024-02-06) |

libtmux/MIGRATION

Lines 71 to 79 in 2a4771c

	| Server | `get_by_id(id)` | `sessions.get(session_id=..., default=None)` | 0.17.0 (2022-12-26) |
	| Session | `list_windows()` / `_list_windows()` | `windows` property | 0.17.0 (2022-12-26) |
	| Session | `where({...})` | `windows.filter(**kwargs)` | 0.17.0 (2022-12-26) |
	| Session | `find_where({...})` | `windows.get(default=None, **kwargs)` | 0.17.0 (2022-12-26) |
	| Session | `get_by_id(id)` | `windows.get(window_id=..., default=None)` | 0.17.0 (2022-12-26) |
	| Window | `list_panes()` / `_list_panes()` | `panes` property | 0.17.0 (2022-12-26) |
	| Window | `where({...})` | `panes.filter(**kwargs)` | 0.17.0 (2022-12-26) |
	| Window | `find_where({...})` | `panes.get(default=None, **kwargs)` | 0.17.0 (2022-12-26) |
	| Window | `get_by_id(id)` | `panes.get(pane_id=..., default=None)` | 0.17.0 (2022-12-26) |

---

Generated with Claude Code

_{- If this code review was useful, please react with a thumbs up. Otherwise, react with a thumbs down.}

[tony]

Code review

No issues found. Checked for bugs and CLAUDE.md compliance.

🤖 Generated with Claude Code

[tony]

Code review

No issues found. Checked for bugs and CLAUDE.md compliance.

🤖 Generated with Claude Code