31 Aug 2019 19:22:12 UTC
- Distribution: Term-Tmux-Layout
- Module version: 1.192431
- Source (raw)
- Browse (raw)
- How to Contribute
- Repository (git clone)
- Testers (371 / 0 / 0)
- KwaliteeBus factor: 1
- 63.57% Coverage
- License: perl_5
- Perl: v5.8.0
- Activity24 month
- Download (23.11KB)
- MetaCPAN Explorer
- Subscribe to distribution
- This version
- Latest versionJMASLAK Joelle Maslak
- SEE ALSO
- COPYRIGHT AND LICENSE
Term::Tmux::Layout - Create tmux layout strings programmatically
my $layout = Term::Tmux::Layout->new(); my $checksum = $layout->set_layout('abc|def');
Set tmux pane layouts using via a simpler interface. See also tmuxlayout which wraps this module in a command-line script.
Defines the width of the terminal window (the entire canvas), with a default of 80.
Defines the height of the terminal window tmux canvas (does not include the status line and command line at the bottom, so this should be one line smaller than the actual terminal emulator window size). This defaults to 24.
This option sets the layout to the string definition provided. The string provided must follow the requirements of
layout()described elsewhere in this document.
This command will determine the current tmux window size (using
get_window_size()) and then calls
layout()to get the layout string in proper tmux format. Finally, it executes tmux to select that layout as the active layout.
You can only run this method from a tmux window.
tmuxlayoutis a thin wrapper around this function.
This method takes a "layout" in a text format, and outputs the proper output.
The layout format consists of a text field of numbers or other characters, separated by new lines. Each character reflects a single pane on the screen, defining its' size in rows and columns.
Some sample layouts:
This would create a layout with 4 panes. The panes would be arranged such that pane 1 takes up the entire vertical canvas, but only 3/5ths of the horizontal canvas. Pane 2 also takes up the entire vertical canvas, but only 1/5 of the horizontal canvas. Pane 3 and 4 are stacked, taking 1/5 of the horizontal canvas, evenly splitting the vertical canvas.
Note that some layouts cannot be displayed by tmux. For example, the following would be invalid:
1122 1134 5556
Tmux divides the entire screen up either horizontally or vertically. However, there is no single horizontal or vertical split that would allow this screen to be divided.
This layout can be passed a single scalar, where the rows are seperated by pipe characters
|or new lines.
If this function is passed an array in the place of the definition, each element starts its own row. Each element can also contain pipe or newlines, and these are also interpreted as row deliminators.
Thus, the following are all valid calls to layout:
$obj->layout('abc|def|ghi'); $obj->layout("abc\ndef\nghi"); $obj->layout('abc', 'def', 'ghi'); $obj->layout('abc|def', 'ghi');
This method performs the tmux checksum, as described in the tmux source code in
layout_checksum(). The input value is the string without the checksum on the front. The output is the checksum value as a string (four hex characters).
This method fetches the window size for the currently active tmux window. If tmux is not running, it instead returns
my $layout = Term::Tmux::Layout( hsize => 80, vsize => 23 );
Create a new layout class. Optionally takes named parameters for the
Break out command execution
There probably should be a Term::Tmux::Command module to execute tmux commands, rather than having the window size commands executed directly by this module.
See tmuxlayout for a command line utility that wraps this module.
Check the issue tracker at: https://github.com/jmaslak/Term-Tmux-Layout/issues
Joelle Maslak <email@example.com>
This software is copyright (c) 2015-2018 by Joelle Maslak.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.
Module Install Instructions
To install Term::Tmux::Layout, copy and paste the appropriate command in to your terminal.
perl -MCPAN -e shell install Term::Tmux::Layout
For more information on module installation, please visit the detailed CPAN module installation guide.