Contributions

[sshmendez]

Hey guys, I would love to contribute. If you all have a list of tasks to build toward more stability I would be more than happy to start working on them. If not then I can start looking at the source and planning my contributions!

[AntonGepting]

Hello,

thank you for your interest in the project and aspiration to participate in development.

even though it was often kind of ad hoc development, but main goals can be formulated as follows:

• support as much tmux features as possible (it would be ideal all of them)
• command builder (compile time validator) according to tmux syntax at user’s application level
• allow full automation using TUI interactions (not dissimilar from users normal behavior)
• tmux "companion/overseer" (starting with and preserving state of tmux in control mode, allowing to store/load sessions, query vars/options/etc "online")

with probably following priorities:

1. core architecture/mechanisms
2. tmux features
3. documentation

current state (tmux 3.3a, arrangement and naming according to tmux manual)

• Core mechanisms (implemented)

  • command building
  • invocation
  • result output

• Tmux commands (implemented)

  • buffers
  • clients and sessions
  • global and session environment
  • hooks
  • key bindings
  • miscellaneous
  • options
  • status line
  • windows and panes

• Helper structures

  • formats (partially implemented)
  • options (partially implemented)
  • styles (partially implemented)
  • target (partially implemented)
  • variables (partially implemented)

• Modes

  • default mode
  • control mode (unimplemented, draft)
  • copy mode (unimplemented, draft)
  • command mode (unimplemented)
  • clock mode (unimplemented)

Certainly I can’t exclude any kind of errors/strange or wrong behavior/bad design/inefficiency/incompleteness/typing mistakes/etc... in all modules listed above even if it's marked as implemented.

Some thoughts/decision making logs were stored in ROADMAP.md and DEVELOPMENT.md files, however not well maintained.

Of course you can take a look at sources/tests and choose what would be interesting specially for you. Any kind of improvements or ideas in relation to development process and project itself can be at least discussed and analyzed, in case of reasonable good solution used/implemented/refactored/redesigned.

I guess that’s it as a small introduction, please feel free to ask if you have any questions or to make your propositions.

See also

tmux man (chapters and features) https://www.man7.org/linux/man-pages/man1/tmux.1.html

library docs (modules overview) https://docs.rs/tmux_interface/latest/tmux_interface/