Improved option management, add hook management

[tony]

Extracted from #513

Warning

APIs below are subject to change (both params, return types, and structures)

Changes

New internal: OptionsMixin

• show_options(): High level objects, e.g. preserving sparse-array data such as command-alias[1], command-alias[99], and inside of a dataclass object.

  command_alias: SparseArray({0: {'split-pane': 'split-window'})

• _show_options(): Map of options split up by key, with raw values.

  command-alias[1] split-pane=split-window

• _show_options_raw(): Raw stdout from tmux show-options

Individual options:

• show_option(): High level objects, e.g. preserving sparse-array data such as command-alias[1], command-alias[99]

  Not sure if this will scale, but will try to get this:

  > show_option('command-alias')
  SparseArray({0: 'split-pane': 'split-window'})
  

  > show_option('command-alias')[0]
  'split-pane': 'split-window'
  

  > show_option('command-alias[0]')
  'split-pane': 'split-window'
  

• _show_option():

• _show_option_raw(): Raw stdout from tmux show-option [option name]

New internal: HooksMixin

New features

• Window.set_option()

  Learned params:

  • format -> -F
  • unset -> -u
  • global -> -g
  • unset_panes -> -U: Also unset other panse in windows
  • prevent_overwrite: -o
  • suppress_warnings: -q
  • append: -a

• Window.show_option()

• Window.show_options()

Breaking changes

Deprecations

• Deprecated Window.set_window_option() in favor of Window.set_option()
• Deprecated Window.show_window_option() in favor of Window.show_option()
• Deprecated Window.show_window_options() in favor of Window.show_options()

Summary by Sourcery

Refactor option and hook management, deprecating old methods.

New Features:

• Add OptionsMixin to manage tmux options.
• Add HooksMixin to manage tmux hooks.
• Introduce new high-level option management methods: show_option(), show_options(), and set_option().
• Add new high-level hook management methods: run_hook(), set_hook(), show_hooks(), show_hook(), and unset_hook().
• Implement SparseArray to handle sparse arrays in options and hooks.

Tests:

• Added tests for new option and hook management methods.

[codecov]

Codecov Report

Attention: Patch coverage is 74.72527% with 184 lines in your changes missing coverage. Please review.

Project coverage is 79.39%. Comparing base (60d1386) to head (7bff126).

Files with missing lines	Patch %	Lines
src/libtmux/hooks.py	31.15%	72 Missing and 23 partials ⚠️
src/libtmux/options.py	70.90%	54 Missing and 26 partials ⚠️
src/libtmux/_internal/constants.py	97.62%	4 Missing and 2 partials ⚠️
src/libtmux/_internal/sparse_array.py	80.00%	3 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##           master     #516      +/-   ##
==========================================
- Coverage   81.52%   79.39%   -2.13%     
==========================================
  Files          37       41       +4     
  Lines        2430     3058     +628     
  Branches      368      462      +94     
==========================================
+ Hits         1981     2428     +447     
- Misses        308      441     +133     
- Partials      141      189      +48     

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