Skip to content

Commit a5df8d9

Browse files
committed
docs(CHANGES): add HooksMixin to new features
why: HooksMixin feature was built but not documented in CHANGES. what: - Add HooksMixin section under "New features" - Document hook methods: set_hook, show_hook, unset_hook - Document bulk operations: get_hook_indices, get_hook_values, set_hooks_bulk, clear_hook, append_hook - Note HooksMixin availability on Server, Session, Window, Pane
1 parent 51fa455 commit a5df8d9

File tree

1 file changed

+18
-0
lines changed

1 file changed

+18
-0
lines changed

CHANGES

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -72,6 +72,24 @@ $ uvx --from 'libtmux' --prerelease allow python
7272
- `suppress_warnings`: `-q`
7373
- `append`: `-a`
7474

75+
#### Hooks
76+
77+
Added {class}`hooks.HooksMixin` for managing tmux hooks programmatically:
78+
79+
- {meth}`~hooks.HooksMixin.set_hook` - Set a hook with optional index
80+
- {meth}`~hooks.HooksMixin.show_hook` - Show current value of a hook
81+
- {meth}`~hooks.HooksMixin.unset_hook` - Remove a hook
82+
83+
Bulk operations API for managing indexed hooks:
84+
85+
- {meth}`~hooks.HooksMixin.get_hook_indices` - Get list of indices that exist for a hook
86+
- {meth}`~hooks.HooksMixin.get_hook_values` - Get all indexed values as SparseArray
87+
- {meth}`~hooks.HooksMixin.set_hooks_bulk` - Set multiple indexed hooks at once
88+
- {meth}`~hooks.HooksMixin.clear_hook` - Unset all indexed values for a hook
89+
- {meth}`~hooks.HooksMixin.append_hook` - Append at next available index
90+
91+
HooksMixin is available on {class}`Server`, {class}`Session`, {class}`Window`, and {class}`Pane`.
92+
7593
## libtmux 0.47.0 (2025-11-01)
7694

7795
### Breaking changes

0 commit comments

Comments
 (0)