| 1 | =pod | ||||||||||||||||||||||||||||
| 2 | |||||||||||||||||||||||||||||
| 3 | =head1 NAME | ||||||||||||||||||||||||||||
| 4 | |||||||||||||||||||||||||||||
| 5 | Term::Shelly - Yet Another Shell Kit for Perl | ||||||||||||||||||||||||||||
| 6 | |||||||||||||||||||||||||||||
| 7 | =head1 VERSION | ||||||||||||||||||||||||||||
| 8 | |||||||||||||||||||||||||||||
| 9 | $Id: Shelly.pm,v 1.5 2004/06/04 04:21:23 psionic Exp $ | ||||||||||||||||||||||||||||
| 10 | |||||||||||||||||||||||||||||
| 11 | =head1 GOAL | ||||||||||||||||||||||||||||
| 12 | |||||||||||||||||||||||||||||
| 13 | I needed a shell kit for an aim client I was writing. All of the Term::ReadLine modules are do blocking reads in doing their readline() functions, and as such are entirely unacceptable. This module is an effort on my part to provide the advanced functionality of great ReadLine modules like Zoid into a package that's more flexible, extendable, and most importantly, allows nonblocking reads to allow other things to happen at the same time. | ||||||||||||||||||||||||||||
| 14 | |||||||||||||||||||||||||||||
| 15 | =head1 NEEDS | ||||||||||||||||||||||||||||
| 16 | |||||||||||||||||||||||||||||
| 17 | - Settable key bindings | ||||||||||||||||||||||||||||
| 18 | - Tab completion | ||||||||||||||||||||||||||||
| 19 | - Support for window size changes (sigwinch) | ||||||||||||||||||||||||||||
| 20 | - movement in-line editing. | ||||||||||||||||||||||||||||
| 21 | - vi mode (Yeah, I lub vi) | ||||||||||||||||||||||||||||
| 22 | - history | ||||||||||||||||||||||||||||
| 23 | - Completion function calls | ||||||||||||||||||||||||||||
| 24 | |||||||||||||||||||||||||||||
| 25 | - Settable callbacks for when we have an end-of-line (EOL binding?) | ||||||||||||||||||||||||||||
| 26 | |||||||||||||||||||||||||||||
| 27 | =cut | ||||||||||||||||||||||||||||
| 28 | |||||||||||||||||||||||||||||
| 29 | package Term::Shelly; | ||||||||||||||||||||||||||||
| 30 | |||||||||||||||||||||||||||||
| 31 | 1 | ▶ | use strict; | ||||||||||||||||||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||
| 32 | 1 | ▶ | use warnings; | ||||||||||||||||||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||
| 33 | |||||||||||||||||||||||||||||
| 34 | 1 | ▶ | use vars qw($VERSION); | ||||||||||||||||||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||
| 35 | 1 | $VERSION = '0.01'; | |||||||||||||||||||||||||||
| 36 | |||||||||||||||||||||||||||||
| 37 | # Default perl modules... | ||||||||||||||||||||||||||||
| 38 | 1 | ▶ | use IO::Handle; # I need flush()... or do i?; | ||||||||||||||||||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||
| 39 | |||||||||||||||||||||||||||||
| 40 | # Get these from CPAN | ||||||||||||||||||||||||||||
| 41 | 1 | ▶ | use Term::ReadKey; | ||||||||||||||||||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||
| 42 | |||||||||||||||||||||||||||||
| 43 | # Useful constants we need... | ||||||||||||||||||||||||||||
| 44 | |||||||||||||||||||||||||||||
| 45 | # for find_word_bound() | ||||||||||||||||||||||||||||
| 46 | 1 | ▶ | use constant WORD_BEGINNING => 0; # I want the beginning of this word. | ||||||||||||||||||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||
| 47 | 1 | ▶ | use constant WORD_END => 1; # I want the end of the word. | ||||||||||||||||||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||
| 48 | 1 | ▶ | use constant WORD_ONLY => 2; # Trailing spaces are important. | ||||||||||||||||||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||
| 49 | 1 | ▶ | use constant WORD_REGEX => 4; # I want to specify my own regexp | ||||||||||||||||||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||
| 50 | |||||||||||||||||||||||||||||
| 51 | # Some key constant name mappings. | ||||||||||||||||||||||||||||
| 52 | 1 | my %KEY_CONSTANTS = ( | |||||||||||||||||||||||||||
| 53 | "\e[A" => "UP", | ||||||||||||||||||||||||||||
| 54 | "\e[B" => "DOWN", | ||||||||||||||||||||||||||||
| 55 | "\e[C" => "RIGHT", | ||||||||||||||||||||||||||||
| 56 | "\e[D" => "LEFT", | ||||||||||||||||||||||||||||
| 57 | ); | ||||||||||||||||||||||||||||
| 58 | |||||||||||||||||||||||||||||
| 59 | # stty raw, basically | ||||||||||||||||||||||||||||
| 60 | 1 | ReadMode 3; | |||||||||||||||||||||||||||
| 61 | |||||||||||||||||||||||||||||
| 62 | # I need to know how big the terminal is (columns, anyway) | ||||||||||||||||||||||||||||
| 63 | |||||||||||||||||||||||||||||
| 64 | =pod | ||||||||||||||||||||||||||||
| 65 | |||||||||||||||||||||||||||||
| 66 | =head1 DESCRIPTION | ||||||||||||||||||||||||||||
| 67 | |||||||||||||||||||||||||||||
| 68 | =over 4 | ||||||||||||||||||||||||||||
| 69 | |||||||||||||||||||||||||||||
| 70 | =cut | ||||||||||||||||||||||||||||
| 71 | |||||||||||||||||||||||||||||
| 72 | 0 | ▶ | sub new ($) { | ||||||||||||||||||||||||||
|
Subroutine
new: not called CC=1 SCAR=6.9
Pod
undocumented
| |||||||||||||||||||||||||||||
| 73 | 0 | my $class = shift; | |||||||||||||||||||||||||||
| 74 | |||||||||||||||||||||||||||||
| 75 | 0 | my $self = { | |||||||||||||||||||||||||||
| 76 | "input_line" => "", | ||||||||||||||||||||||||||||
| 77 | "input_position" => 0, | ||||||||||||||||||||||||||||
| 78 | "leftcol" => 0, | ||||||||||||||||||||||||||||
| 79 | }; | ||||||||||||||||||||||||||||
| 80 | |||||||||||||||||||||||||||||
| 81 | 0 | bless $self, $class; | |||||||||||||||||||||||||||
| 82 | |||||||||||||||||||||||||||||
| 83 | 0 | ($self->{"termcols"}) = GetTerminalSize(); | |||||||||||||||||||||||||||
| 84 | 0 | ▶ | $SIG{WINCH} = sub { ($self->{"termcols"}) = GetTerminalSize(); $self->fix_inputline() }; | ||||||||||||||||||||||||||
|
Subroutine
__ANON__: not called CC=1 SCAR=6.9
| |||||||||||||||||||||||||||||
| 85 | 0 | my $bindings = { | |||||||||||||||||||||||||||
| 86 | "LEFT" => "backward-char", | ||||||||||||||||||||||||||||
| 87 | "RIGHT" => "forward-char", | ||||||||||||||||||||||||||||
| 88 | "UP" => "up-history", | ||||||||||||||||||||||||||||
| 89 | "DOWN" => "down-history", | ||||||||||||||||||||||||||||
| 90 | |||||||||||||||||||||||||||||
| 91 | "BACKSPACE" => "delete-char-backward", | ||||||||||||||||||||||||||||
| 92 | "^H" => "delete-char-backward", | ||||||||||||||||||||||||||||
| 93 | "^?" => "delete-char-backward", | ||||||||||||||||||||||||||||
| 94 | "^W" => "delete-word-backward", | ||||||||||||||||||||||||||||
| 95 | |||||||||||||||||||||||||||||
| 96 | "^U" => "kill-line", | ||||||||||||||||||||||||||||
| 97 | |||||||||||||||||||||||||||||
| 98 | "^J" => "newline", | ||||||||||||||||||||||||||||
| 99 | "^M" => "newline", | ||||||||||||||||||||||||||||
| 100 | |||||||||||||||||||||||||||||
| 101 | "^A" => "beginning-of-line", | ||||||||||||||||||||||||||||
| 102 | "^E" => "end-of-line", | ||||||||||||||||||||||||||||
| 103 | "^K" => "kill-to-eol", | ||||||||||||||||||||||||||||
| 104 | "^L" => "redraw", | ||||||||||||||||||||||||||||
| 105 | |||||||||||||||||||||||||||||
| 106 | "^I" => "complete-word", | ||||||||||||||||||||||||||||
| 107 | "TAB" => "complete-word", | ||||||||||||||||||||||||||||
| 108 | |||||||||||||||||||||||||||||
| 109 | #"^T" => "expand-line", | ||||||||||||||||||||||||||||
| 110 | }; | ||||||||||||||||||||||||||||
| 111 | |||||||||||||||||||||||||||||
| 112 | 0 | my $mappings = { | |||||||||||||||||||||||||||
| 113 | "backward-char" => \&backward_char, | ||||||||||||||||||||||||||||
| 114 | "forward-char" => \&forward_char, | ||||||||||||||||||||||||||||
| 115 | "delete-char-backward" => \&delete_char_backward, | ||||||||||||||||||||||||||||
| 116 | "kill-line" => \&kill_line, | ||||||||||||||||||||||||||||
| 117 | "newline" => \&newline, | ||||||||||||||||||||||||||||
| 118 | "redraw" => \&fix_inputline, | ||||||||||||||||||||||||||||
| 119 | "beginning-of-line" => \&beginning_of_line, | ||||||||||||||||||||||||||||
| 120 | "end-of-line" => \&end_of_line, | ||||||||||||||||||||||||||||
| 121 | "delete-word-backward" => \&delete_word_backward, | ||||||||||||||||||||||||||||
| 122 | |||||||||||||||||||||||||||||
| 123 | "complete-word" => \&complete_word, | ||||||||||||||||||||||||||||
| 124 | #"expand-line" => \&expand_line, | ||||||||||||||||||||||||||||
| 125 | }; | ||||||||||||||||||||||||||||
| 126 | |||||||||||||||||||||||||||||
| 127 | 0 | $self->{"bindings"} = $bindings; | |||||||||||||||||||||||||||
| 128 | 0 | $self->{"mappings"} = $mappings; | |||||||||||||||||||||||||||
| 129 | 0 | return $self; | |||||||||||||||||||||||||||
| 130 | } | ||||||||||||||||||||||||||||
| 131 | |||||||||||||||||||||||||||||
| 132 | =pod | ||||||||||||||||||||||||||||
| 133 | |||||||||||||||||||||||||||||
| 134 | =item $sh->do_one_loop() | ||||||||||||||||||||||||||||
| 135 | |||||||||||||||||||||||||||||
| 136 | Does... one... loop. Makes a pass at grabbing input and processing it. For | ||||||||||||||||||||||||||||
| 137 | speedy pasts, this loops until there are no characters left to read. | ||||||||||||||||||||||||||||
| 138 | It will handle event processing, etc. | ||||||||||||||||||||||||||||
| 139 | |||||||||||||||||||||||||||||
| 140 | =cut | ||||||||||||||||||||||||||||
| 141 | |||||||||||||||||||||||||||||
| 142 | # Nonblocking readline | ||||||||||||||||||||||||||||
| 143 | 0 | ▶ | sub do_one_loop ($) { | ||||||||||||||||||||||||||
|
Subroutine
do_one_loop: not called CC=2 SCAR=17.9
Pod
documented
| |||||||||||||||||||||||||||||
| 144 | 0 | my $self = shift; | |||||||||||||||||||||||||||
| 145 | 0 | my $char; | |||||||||||||||||||||||||||
| 146 | |||||||||||||||||||||||||||||
| 147 | # ReadKey(.1) means no timeout waiting for data, thus is nonblocking | ||||||||||||||||||||||||||||
| 148 | 0 | ▶ | while (defined($char = ReadKey(.1))) { | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 149 | 0 | $self->handle_key($char); | |||||||||||||||||||||||||||
| 150 | } | ||||||||||||||||||||||||||||
| 151 | |||||||||||||||||||||||||||||
| 152 | } | ||||||||||||||||||||||||||||
| 153 | |||||||||||||||||||||||||||||
| 154 | =pod | ||||||||||||||||||||||||||||
| 155 | |||||||||||||||||||||||||||||
| 156 | =item handle_key($key) | ||||||||||||||||||||||||||||
| 157 | |||||||||||||||||||||||||||||
| 158 | Handle a single character input. This is not a "key press" so much as doing all | ||||||||||||||||||||||||||||
| 159 | the necessary things to handle key presses. | ||||||||||||||||||||||||||||
| 160 | |||||||||||||||||||||||||||||
| 161 | =cut | ||||||||||||||||||||||||||||
| 162 | |||||||||||||||||||||||||||||
| 163 | 0 | ▶ | sub handle_key($$) { | ||||||||||||||||||||||||||
|
Subroutine
handle_key: not called CC=15 SCAR=54.8
Pod
documented
| |||||||||||||||||||||||||||||
| 164 | 0 | my $self = shift; | |||||||||||||||||||||||||||
| 165 | 0 | my $char = shift; | |||||||||||||||||||||||||||
| 166 | |||||||||||||||||||||||||||||
| 167 | 0 | ▶ | my $line = $self->{"input_line"} || ""; | ||||||||||||||||||||||||||
|
Condition0%0/2
$self->{'input_line'} || ''
MC/DC0%0/1
$self->{'input_line'} || ''
$self->{'input_line'}
Truth table0%0/2
A
A= $self->{'input_line'}
| |||||||||||||||||||||||||||||
| 168 | 0 | ▶ | my $pos = $self->{"input_position"} || 0; | ||||||||||||||||||||||||||
|
Condition0%0/2
$self->{'input_position'} || 0
MC/DC0%0/1
$self->{'input_position'} || 0
$self->{'input_position'}
Truth table0%0/2
A
A= $self->{'input_position'}
| |||||||||||||||||||||||||||||
| 169 | |||||||||||||||||||||||||||||
| 170 | 0 | ▶ | if ($self->{"escape"}) { | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 171 | 0 | $self->{"escape_string"} .= $char; | |||||||||||||||||||||||||||
| 172 | 0 | ▶ | if ($self->{"escape_expect_ansi"}) { | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 173 | 0 | ▶ | $self->{"escape_expect_ansi"} = 0 if ($char =~ m/[a-zA-Z]/); | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 174 | } | ||||||||||||||||||||||||||||
| 175 | |||||||||||||||||||||||||||||
| 176 | 0 | ▶ | $self->{"escape_expect_ansi"} = 1 if ($char eq '['); | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 177 | 0 | ▶ | $self->{"escape"} = 0 unless ($self->{"escape_expect_ansi"}); | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 178 | |||||||||||||||||||||||||||||
| 179 | 0 | ▶ | unless ($self->{"escape_expect_ansi"}) { | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 180 | 0 | my $estring = $self->{"escape_string"}; | |||||||||||||||||||||||||||
| 181 | |||||||||||||||||||||||||||||
| 182 | 0 | $self->{"escape_string"} = undef; | |||||||||||||||||||||||||||
| 183 | 0 | return $self->execute_binding("\e".$estring); | |||||||||||||||||||||||||||
| 184 | } | ||||||||||||||||||||||||||||
| 185 | |||||||||||||||||||||||||||||
| 186 | 0 | return 0; | |||||||||||||||||||||||||||
| 187 | } | ||||||||||||||||||||||||||||
| 188 | |||||||||||||||||||||||||||||
| 189 | 0 | ▶ | if ($char eq "\e") { # Trap escapes, they're speshul. | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 190 | 0 | $self->{"escape"} = 1; | |||||||||||||||||||||||||||
| 191 | 0 | $self->{"escape_string"} = undef; | |||||||||||||||||||||||||||
| 192 | |||||||||||||||||||||||||||||
| 193 | # What now? | ||||||||||||||||||||||||||||
| 194 | 0 | return 0; | |||||||||||||||||||||||||||
| 195 | } | ||||||||||||||||||||||||||||
| 196 | |||||||||||||||||||||||||||||
| 197 | 0 | ▶ | if ((ord($char) < 32) || (ord($char) > 126)) { # Control character | ||||||||||||||||||||||||||
|
Branch: 1 branch
Condition0%0/3
ord $char < 32 or ord $char > 126
MC/DC0%0/2
ord $char < 32 or ord $char > 126
ord $char < 32
ord $char > 126
Truth table0%0/3
A or B
A= ord $char < 32B= ord $char > 126
| |||||||||||||||||||||||||||||
| 198 | 0 | $self->execute_binding($char); | |||||||||||||||||||||||||||
| 199 | 0 | return 0; | |||||||||||||||||||||||||||
| 200 | } | ||||||||||||||||||||||||||||
| 201 | |||||||||||||||||||||||||||||
| 202 | 0 | ▶ | if ((defined($char)) && (ord($char) >= 32)) { | ||||||||||||||||||||||||||
|
Branch: 1 branch
Condition0%0/3
defined $char and ord $char >= 32
MC/DC0%0/2
defined $char and ord $char >= 32
defined $char
ord $char >= 32
Truth table0%0/3
A and B
A= defined $charB= ord $char >= 32
| |||||||||||||||||||||||||||||
| 203 | 0 | substr($line, $pos, 0) = $char; | |||||||||||||||||||||||||||
| 204 | 0 | $self->{"input_position"}++; | |||||||||||||||||||||||||||
| 205 | |||||||||||||||||||||||||||||
| 206 | # If we just did a tab completion, kill the state. | ||||||||||||||||||||||||||||
| 207 | 0 | ▶ | delete($self->{"completion"}) if (defined($self->{"completion"})); | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 208 | } | ||||||||||||||||||||||||||||
| 209 | |||||||||||||||||||||||||||||
| 210 | 0 | $self->{"input_line"} = $line; | |||||||||||||||||||||||||||
| 211 | 0 | $self->fix_inputline(); | |||||||||||||||||||||||||||
| 212 | } | ||||||||||||||||||||||||||||
| 213 | |||||||||||||||||||||||||||||
| 214 | =pod | ||||||||||||||||||||||||||||
| 215 | |||||||||||||||||||||||||||||
| 216 | =item execute_binding(raw_key) | ||||||||||||||||||||||||||||
| 217 | |||||||||||||||||||||||||||||
| 218 | Guess what this does? Ok I'll explain anyway... It takes a key and prettifies | ||||||||||||||||||||||||||||
| 219 | it, then checks the known key bindings for a mapping and checks if that mapping | ||||||||||||||||||||||||||||
| 220 | is a coderef (a function reference). If it is, it'll call that function. If | ||||||||||||||||||||||||||||
| 221 | not, it'll do nothing. If it finds a binding for which there is no mapped | ||||||||||||||||||||||||||||
| 222 | function, it'll tell you that it is an unimplemented function. | ||||||||||||||||||||||||||||
| 223 | |||||||||||||||||||||||||||||
| 224 | =cut | ||||||||||||||||||||||||||||
| 225 | |||||||||||||||||||||||||||||
| 226 | 0 | ▶ | sub execute_binding ($$) { | ||||||||||||||||||||||||||
|
Subroutine
execute_binding: not called CC=5 SCAR=34.0
Pod
documented
| |||||||||||||||||||||||||||||
| 227 | 0 | my $self = shift; | |||||||||||||||||||||||||||
| 228 | 0 | my $str = shift; | |||||||||||||||||||||||||||
| 229 | 0 | my $key = $self->prettify_key($str); | |||||||||||||||||||||||||||
| 230 | |||||||||||||||||||||||||||||
| 231 | 0 | my $bindings = $self->{"bindings"}; | |||||||||||||||||||||||||||
| 232 | 0 | my $mappings = $self->{"mappings"}; | |||||||||||||||||||||||||||
| 233 | |||||||||||||||||||||||||||||
| 234 | 0 | ▶ | if (defined($bindings->{$key})) { | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 235 | |||||||||||||||||||||||||||||
| 236 | # Check if we have stored completion state and the next binding is | ||||||||||||||||||||||||||||
| 237 | # not complete-word. If it isn't, then kill the completion state. | ||||||||||||||||||||||||||||
| 238 | 0 | ▶ | if (defined($self->{"completion"}) && | ||||||||||||||||||||||||||
|
Branch: 1 branch
Condition0%0/3
defined $self->{"completion"} and $bindings->{$key} ne "complete-word"
MC/DC0%0/2
defined $self->{"completion"} and $bindings->{$key} ne "complete-word"
defined $self->{"completion"}
$bindings->{$key} ne "complete-word"
Truth table0%0/3
A and B
A= defined $self->{"completion"}B= $bindings->{$key} ne "complete-word"
| |||||||||||||||||||||||||||||
| 239 | $bindings->{$key} ne 'complete-word') { | ||||||||||||||||||||||||||||
| 240 | 0 | delete($self->{"completion"}); | |||||||||||||||||||||||||||
| 241 | } | ||||||||||||||||||||||||||||
| 242 | |||||||||||||||||||||||||||||
| 243 | 0 | ▶ | if (ref($mappings->{$bindings->{$key}}) eq 'CODE') { | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 244 | |||||||||||||||||||||||||||||
| 245 | # This is a hack, passing $self instead of doing: | ||||||||||||||||||||||||||||
| 246 | # $self->function, becuase I don't want to do an eval. | ||||||||||||||||||||||||||||
| 247 | |||||||||||||||||||||||||||||
| 248 | 0 | return &{$mappings->{$bindings->{$key}}}($self); | |||||||||||||||||||||||||||
| 249 | |||||||||||||||||||||||||||||
| 250 | } else { | ||||||||||||||||||||||||||||
| 251 | 0 | error("Unimplemented function, " . $bindings->{$key}); | |||||||||||||||||||||||||||
| 252 | } | ||||||||||||||||||||||||||||
| 253 | } | ||||||||||||||||||||||||||||
| 254 | |||||||||||||||||||||||||||||
| 255 | 0 | return 0; | |||||||||||||||||||||||||||
| 256 | } | ||||||||||||||||||||||||||||
| 257 | |||||||||||||||||||||||||||||
| 258 | =pod | ||||||||||||||||||||||||||||
| 259 | |||||||||||||||||||||||||||||
| 260 | =item prettify_key(raw_key) | ||||||||||||||||||||||||||||
| 261 | |||||||||||||||||||||||||||||
| 262 | This happy function lets me turn raw input into something less ugly. It turns | ||||||||||||||||||||||||||||
| 263 | control keys into their equivalent ^X form. It does some other things to turn | ||||||||||||||||||||||||||||
| 264 | the key into something more readable | ||||||||||||||||||||||||||||
| 265 | |||||||||||||||||||||||||||||
| 266 | =cut | ||||||||||||||||||||||||||||
| 267 | |||||||||||||||||||||||||||||
| 268 | 0 | ▶ | sub prettify_key ($$) { | ||||||||||||||||||||||||||
|
Subroutine
prettify_key: not called CC=7 SCAR=40.3
Pod
documented
| |||||||||||||||||||||||||||||
| 269 | 0 | my $self = shift; | |||||||||||||||||||||||||||
| 270 | 0 | my $key = shift; | |||||||||||||||||||||||||||
| 271 | |||||||||||||||||||||||||||||
| 272 | # Return ^X for control characters, like CTRL+A... | ||||||||||||||||||||||||||||
| 273 | 0 | ▶ | if (length($key) == 1) { # One-character keycombos should only be ctrl keys | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 274 | 0 | ▶ | if (ord($key) <= 26) { # Control codes, another check anyway... | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 275 | 0 | return "^" . chr(65 + ord($key) - 1); | |||||||||||||||||||||||||||
| 276 | } | ||||||||||||||||||||||||||||
| 277 | 0 | ▶ | if (ord($key) == 127) { # Speshul backspace key | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 278 | 0 | return "^?"; | |||||||||||||||||||||||||||
| 279 | } | ||||||||||||||||||||||||||||
| 280 | 0 | ▶ | if (ord($key) < 32) { | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 281 | 0 | return "^" . (split("", "\]_^"))[ord($key) - 28]; | |||||||||||||||||||||||||||
| 282 | } | ||||||||||||||||||||||||||||
| 283 | } | ||||||||||||||||||||||||||||
| 284 | |||||||||||||||||||||||||||||
| 285 | # Return ESC-X for escape shenanigans, like ESC-W | ||||||||||||||||||||||||||||
| 286 | 0 | ▶ | if (length($key) == 2) { | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 287 | 0 | my ($p, $k) = split("", $key); | |||||||||||||||||||||||||||
| 288 | 0 | ▶ | if ($p eq "\e") { # This should always be an escape, but.. check anyway | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 289 | 0 | return "ESC-" . $k; | |||||||||||||||||||||||||||
| 290 | } | ||||||||||||||||||||||||||||
| 291 | } | ||||||||||||||||||||||||||||
| 292 | |||||||||||||||||||||||||||||
| 293 | # Ok, so it's not ^X or ESC-X, it's gotta be some ansi funk. | ||||||||||||||||||||||||||||
| 294 | 0 | return $KEY_CONSTANTS{$key}; | |||||||||||||||||||||||||||
| 295 | } | ||||||||||||||||||||||||||||
| 296 | |||||||||||||||||||||||||||||
| 297 | =pod | ||||||||||||||||||||||||||||
| 298 | |||||||||||||||||||||||||||||
| 299 | =item real_out($string) | ||||||||||||||||||||||||||||
| 300 | |||||||||||||||||||||||||||||
| 301 | This function allows you to bypass any sort of evil shenanigans regarding output fudging. All this does is 'print @_;' | ||||||||||||||||||||||||||||
| 302 | |||||||||||||||||||||||||||||
| 303 | Don't use this unless you know what you're doing. | ||||||||||||||||||||||||||||
| 304 | |||||||||||||||||||||||||||||
| 305 | =cut | ||||||||||||||||||||||||||||
| 306 | |||||||||||||||||||||||||||||
| 307 | 0 | ▶ | sub real_out { | ||||||||||||||||||||||||||
|
Subroutine
real_out: not called CC=1 SCAR=6.9
Pod
documented
| |||||||||||||||||||||||||||||
| 308 | 0 | my $self = shift; | |||||||||||||||||||||||||||
| 309 | 0 | print @_; | |||||||||||||||||||||||||||
| 310 | } | ||||||||||||||||||||||||||||
| 311 | |||||||||||||||||||||||||||||
| 312 | 0 | ▶ | sub out ($;$) { | ||||||||||||||||||||||||||
|
Subroutine
out: not called CC=1 SCAR=6.9
Pod
undocumented
| |||||||||||||||||||||||||||||
| 313 | 0 | my $self = shift; | |||||||||||||||||||||||||||
| 314 | 0 | $self->real_out("\r\e[2K", @_, "\n"); | |||||||||||||||||||||||||||
| 315 | 0 | $self->fix_inputline(); | |||||||||||||||||||||||||||
| 316 | } | ||||||||||||||||||||||||||||
| 317 | |||||||||||||||||||||||||||||
| 318 | 0 | ▶ | sub error ($$) { | ||||||||||||||||||||||||||
|
Subroutine
error: not called CC=1 SCAR=6.9
Pod
undocumented
| |||||||||||||||||||||||||||||
| 319 | 0 | my $self = shift; | |||||||||||||||||||||||||||
| 320 | 0 | print STDERR "*> ", @_, "\n"; | |||||||||||||||||||||||||||
| 321 | 0 | $self->fix_inputline(); | |||||||||||||||||||||||||||
| 322 | } | ||||||||||||||||||||||||||||
| 323 | |||||||||||||||||||||||||||||
| 324 | =pod | ||||||||||||||||||||||||||||
| 325 | |||||||||||||||||||||||||||||
| 326 | =item fix_inputline | ||||||||||||||||||||||||||||
| 327 | |||||||||||||||||||||||||||||
| 328 | This super-happy function redraws the input line. If input_position is beyond the bounds of the terminal, it'll shuffle around so that it can display it. This function is called just about any time any key is hit. | ||||||||||||||||||||||||||||
| 329 | |||||||||||||||||||||||||||||
| 330 | =cut | ||||||||||||||||||||||||||||
| 331 | |||||||||||||||||||||||||||||
| 332 | 0 | ▶ | sub fix_inputline { | ||||||||||||||||||||||||||
|
Subroutine
fix_inputline: not called CC=6 SCAR=37.4
Pod
documented
| |||||||||||||||||||||||||||||
| 333 | 0 | my $self = shift; | |||||||||||||||||||||||||||
| 334 | |||||||||||||||||||||||||||||
| 335 | 0 | print "\r\e[2K"; | |||||||||||||||||||||||||||
| 336 | |||||||||||||||||||||||||||||
| 337 | # If we're past the end of the terminal line, shuffle back! | ||||||||||||||||||||||||||||
| 338 | 0 | ▶ | if ($self->{"input_position"} - $self->{"leftcol"} <= 0) { | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 339 | 0 | $self->{"leftcol"} -= 30; | |||||||||||||||||||||||||||
| 340 | 0 | ▶ | $self->{"leftcol"} = 0 if ($self->{"leftcol"} < 0); | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 341 | } | ||||||||||||||||||||||||||||
| 342 | |||||||||||||||||||||||||||||
| 343 | # If we're before the beginning of the terminal line, shuffle over! | ||||||||||||||||||||||||||||
| 344 | 0 | ▶ | if ($self->{"input_position"} - $self->{"leftcol"} > $self->{"termcols"}) { | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 345 | 0 | $self->{"leftcol"} += 30; | |||||||||||||||||||||||||||
| 346 | } | ||||||||||||||||||||||||||||
| 347 | |||||||||||||||||||||||||||||
| 348 | # Can se show the whole line? If so, do it! | ||||||||||||||||||||||||||||
| 349 | 0 | ▶ | if (length($self->{"input_line"}) < $self->{"termcols"}) { | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 350 | 0 | $self->{"leftcol"} = 0; | |||||||||||||||||||||||||||
| 351 | } | ||||||||||||||||||||||||||||
| 352 | |||||||||||||||||||||||||||||
| 353 | # only print as much as we can in this one line. | ||||||||||||||||||||||||||||
| 354 | 0 | print substr($self->{"input_line"}, $self->{"leftcol"}, $self->{"termcols"}); | |||||||||||||||||||||||||||
| 355 | 0 | print "\r"; | |||||||||||||||||||||||||||
| 356 | print "\e[" . ($self->{"input_position"} - $self->{"leftcol"}) . | ||||||||||||||||||||||||||||
| 357 | 0 | ▶ | "C" if ($self->{"input_position"} > 0); | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 358 | 0 | STDOUT->flush(); | |||||||||||||||||||||||||||
| 359 | } | ||||||||||||||||||||||||||||
| 360 | |||||||||||||||||||||||||||||
| 361 | 0 | ▶ | sub newline { | ||||||||||||||||||||||||||
|
Subroutine
newline: not called CC=1 SCAR=6.9
Pod
undocumented
| |||||||||||||||||||||||||||||
| 362 | 0 | my $self = shift; | |||||||||||||||||||||||||||
| 363 | # Process the input line. | ||||||||||||||||||||||||||||
| 364 | |||||||||||||||||||||||||||||
| 365 | 0 | $self->real_out("\n"); | |||||||||||||||||||||||||||
| 366 | 0 | print "You wrote: " . $self->{"input_line"} . "\n"; | |||||||||||||||||||||||||||
| 367 | |||||||||||||||||||||||||||||
| 368 | 0 | $self->{"input_line"} = ""; | |||||||||||||||||||||||||||
| 369 | 0 | $self->{"input_position"} = 0; | |||||||||||||||||||||||||||
| 370 | } | ||||||||||||||||||||||||||||
| 371 | |||||||||||||||||||||||||||||
| 372 | 0 | ▶ | sub kill_line { | ||||||||||||||||||||||||||
|
Subroutine
kill_line: not called CC=1 SCAR=6.9
Pod
undocumented
| |||||||||||||||||||||||||||||
| 373 | 0 | my $self = shift; | |||||||||||||||||||||||||||
| 374 | 0 | $self->{"input_line"} = ""; | |||||||||||||||||||||||||||
| 375 | 0 | $self->{"input_position"} = 0; | |||||||||||||||||||||||||||
| 376 | 0 | $self->{"leftcol"} = 0; | |||||||||||||||||||||||||||
| 377 | |||||||||||||||||||||||||||||
| 378 | #real_out("\r\e[2K"); | ||||||||||||||||||||||||||||
| 379 | |||||||||||||||||||||||||||||
| 380 | 0 | $self->fix_inputline(); | |||||||||||||||||||||||||||
| 381 | |||||||||||||||||||||||||||||
| 382 | 0 | return 0; | |||||||||||||||||||||||||||
| 383 | } | ||||||||||||||||||||||||||||
| 384 | |||||||||||||||||||||||||||||
| 385 | 0 | ▶ | sub forward_char { | ||||||||||||||||||||||||||
|
Subroutine
forward_char: not called CC=2 SCAR=17.9
Pod
undocumented
| |||||||||||||||||||||||||||||
| 386 | 0 | my $self = shift; | |||||||||||||||||||||||||||
| 387 | 0 | ▶ | if ($self->{"input_position"} < length($self->{"input_line"})) { | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 388 | 0 | $self->{"input_position"}++; | |||||||||||||||||||||||||||
| 389 | 0 | $self->real_out("\e[C"); | |||||||||||||||||||||||||||
| 390 | } | ||||||||||||||||||||||||||||
| 391 | } | ||||||||||||||||||||||||||||
| 392 | |||||||||||||||||||||||||||||
| 393 | 0 | ▶ | sub backward_char { | ||||||||||||||||||||||||||
|
Subroutine
backward_char: not called CC=2 SCAR=17.9
Pod
undocumented
| |||||||||||||||||||||||||||||
| 394 | 0 | my $self = shift; | |||||||||||||||||||||||||||
| 395 | 0 | ▶ | if ($self->{"input_position"} > 0) { | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 396 | 0 | $self->{"input_position"}--; | |||||||||||||||||||||||||||
| 397 | 0 | $self->real_out("\e[D"); | |||||||||||||||||||||||||||
| 398 | } | ||||||||||||||||||||||||||||
| 399 | } | ||||||||||||||||||||||||||||
| 400 | |||||||||||||||||||||||||||||
| 401 | 0 | ▶ | sub delete_char_backward { | ||||||||||||||||||||||||||
|
Subroutine
delete_char_backward: not called CC=2 SCAR=17.9
Pod
undocumented
| |||||||||||||||||||||||||||||
| 402 | 0 | my $self = shift; | |||||||||||||||||||||||||||
| 403 | #"delete-char-backward" => \&delete_char_backward, | ||||||||||||||||||||||||||||
| 404 | 0 | ▶ | if ($self->{"input_position"} > 0) { | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 405 | 0 | substr($self->{"input_line"}, $self->{"input_position"} - 1, 1) = ''; | |||||||||||||||||||||||||||
| 406 | 0 | $self->{"input_position"}--; | |||||||||||||||||||||||||||
| 407 | |||||||||||||||||||||||||||||
| 408 | 0 | $self->fix_inputline(); | |||||||||||||||||||||||||||
| 409 | } | ||||||||||||||||||||||||||||
| 410 | } | ||||||||||||||||||||||||||||
| 411 | |||||||||||||||||||||||||||||
| 412 | 0 | ▶ | sub beginning_of_line { | ||||||||||||||||||||||||||
|
Subroutine
beginning_of_line: not called CC=1 SCAR=6.9
Pod
undocumented
| |||||||||||||||||||||||||||||
| 413 | 0 | my $self = shift; | |||||||||||||||||||||||||||
| 414 | 0 | $self->{"input_position"} = 0; | |||||||||||||||||||||||||||
| 415 | 0 | $self->{"leftcol"} = 0; | |||||||||||||||||||||||||||
| 416 | 0 | $self->fix_inputline(); | |||||||||||||||||||||||||||
| 417 | } | ||||||||||||||||||||||||||||
| 418 | |||||||||||||||||||||||||||||
| 419 | 0 | ▶ | sub end_of_line { | ||||||||||||||||||||||||||
|
Subroutine
end_of_line: not called CC=1 SCAR=6.9
Pod
undocumented
| |||||||||||||||||||||||||||||
| 420 | 0 | my $self = shift; | |||||||||||||||||||||||||||
| 421 | 0 | $self->{"input_position"} = length($self->{"input_line"}); | |||||||||||||||||||||||||||
| 422 | 0 | $self->fix_inputline(); | |||||||||||||||||||||||||||
| 423 | } | ||||||||||||||||||||||||||||
| 424 | |||||||||||||||||||||||||||||
| 425 | 0 | ▶ | sub delete_word_backward { | ||||||||||||||||||||||||||
|
Subroutine
delete_word_backward: not called CC=1 SCAR=6.9
Pod
undocumented
| |||||||||||||||||||||||||||||
| 426 | 0 | my $self = shift; | |||||||||||||||||||||||||||
| 427 | 0 | my $pos = $self->{"input_position"}; | |||||||||||||||||||||||||||
| 428 | 0 | my $line = $self->{"input_line"}; | |||||||||||||||||||||||||||
| 429 | 0 | my $regex = "[A-Za-z0-9]"; | |||||||||||||||||||||||||||
| 430 | 0 | my $bword; | |||||||||||||||||||||||||||
| 431 | |||||||||||||||||||||||||||||
| 432 | 0 | $bword = $self->find_word_bound($line, $pos, WORD_BEGINNING); | |||||||||||||||||||||||||||
| 433 | |||||||||||||||||||||||||||||
| 434 | # Delete whatever word we just found. | ||||||||||||||||||||||||||||
| 435 | 0 | substr($line, $bword, $pos - $bword) = ''; | |||||||||||||||||||||||||||
| 436 | |||||||||||||||||||||||||||||
| 437 | # Update stuff... | ||||||||||||||||||||||||||||
| 438 | 0 | $self->{"input_line"} = $line; | |||||||||||||||||||||||||||
| 439 | 0 | $self->{"input_position"} -= ($pos - $bword); | |||||||||||||||||||||||||||
| 440 | |||||||||||||||||||||||||||||
| 441 | 0 | $self->fix_inputline(); | |||||||||||||||||||||||||||
| 442 | } | ||||||||||||||||||||||||||||
| 443 | |||||||||||||||||||||||||||||
| 444 | =pod | ||||||||||||||||||||||||||||
| 445 | |||||||||||||||||||||||||||||
| 446 | =item $sh->complete_word | ||||||||||||||||||||||||||||
| 447 | |||||||||||||||||||||||||||||
| 448 | This is called whenever the complete-word binding is triggered. See the | ||||||||||||||||||||||||||||
| 449 | COMPLETION section below for how to write your own completion function. | ||||||||||||||||||||||||||||
| 450 | |||||||||||||||||||||||||||||
| 451 | =cut | ||||||||||||||||||||||||||||
| 452 | |||||||||||||||||||||||||||||
| 453 | 0 | ▶ | sub complete_word { | ||||||||||||||||||||||||||
|
Subroutine
complete_word: not called CC=6 SCAR=37.4
Pod
documented
| |||||||||||||||||||||||||||||
| 454 | 0 | my $self = shift; | |||||||||||||||||||||||||||
| 455 | 0 | my $pos = $self->{"input_position"}; | |||||||||||||||||||||||||||
| 456 | 0 | my $line = $self->{"input_line"}; | |||||||||||||||||||||||||||
| 457 | 0 | my $regex = "[A-Za-z0-9]"; | |||||||||||||||||||||||||||
| 458 | 0 | my $bword; | |||||||||||||||||||||||||||
| 459 | my $complete; | ||||||||||||||||||||||||||||
| 460 | |||||||||||||||||||||||||||||
| 461 | 0 | ▶ | if (ref($self->{"completion_function"}) eq 'CODE') { | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 462 | 0 | my @matches; | |||||||||||||||||||||||||||
| 463 | |||||||||||||||||||||||||||||
| 464 | # Maintain some sort of state here if this is the first time we've | ||||||||||||||||||||||||||||
| 465 | # hit complete_word() for this "scenario." What I mean is, we need to track | ||||||||||||||||||||||||||||
| 466 | # whether or not this user is hitting tab once or twice (or more) in the | ||||||||||||||||||||||||||||
| 467 | # same position. | ||||||||||||||||||||||||||||
| 468 | RECHECK: | ||||||||||||||||||||||||||||
| 469 | 0 | ▶ | if (!defined($self->{"completion"})) { | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 470 | 0 | $bword = $self->find_word_bound($line, $pos, WORD_BEGINNING | WORD_REGEX, '\S'); | |||||||||||||||||||||||||||
| 471 | 0 | $complete = substr($line,$bword,$pos - $bword); | |||||||||||||||||||||||||||
| 472 | #$self->out("Complete: $complete"); | ||||||||||||||||||||||||||||
| 473 | |||||||||||||||||||||||||||||
| 474 | #$self->out("First time completing $complete"); | ||||||||||||||||||||||||||||
| 475 | 0 | $self->{"completion"} = { | |||||||||||||||||||||||||||
| 476 | "index" => 0, | ||||||||||||||||||||||||||||
| 477 | "original" => $complete, | ||||||||||||||||||||||||||||
| 478 | "pos" => $pos, | ||||||||||||||||||||||||||||
| 479 | "bword" => $bword, | ||||||||||||||||||||||||||||
| 480 | "line" => $line, | ||||||||||||||||||||||||||||
| 481 | "endpos" => $pos, | ||||||||||||||||||||||||||||
| 482 | }; | ||||||||||||||||||||||||||||
| 483 | } else { | ||||||||||||||||||||||||||||
| 484 | 0 | $bword = $self->{"completion"}->{"bword"}; | |||||||||||||||||||||||||||
| 485 | 0 | $complete = substr($line,$bword,$pos - $bword); | |||||||||||||||||||||||||||
| 486 | } | ||||||||||||||||||||||||||||
| 487 | |||||||||||||||||||||||||||||
| 488 | # If we don't have any matches to check against... | ||||||||||||||||||||||||||||
| 489 | 0 | ▶ | unless (defined($self->{"completion"}->{"matches"})) { | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 490 | @matches = | ||||||||||||||||||||||||||||
| 491 | 0 | &{$self->{"completion_function"}}($line, $bword, $pos, $complete); | |||||||||||||||||||||||||||
| 492 | 0 | @{$self->{"completion"}->{"matches"}} = @matches; | |||||||||||||||||||||||||||
| 493 | } else { | ||||||||||||||||||||||||||||
| 494 | 0 | @matches = @{$self->{"completion"}->{"matches"}}; | |||||||||||||||||||||||||||
| 495 | } | ||||||||||||||||||||||||||||
| 496 | |||||||||||||||||||||||||||||
| 497 | 0 | my $match = $matches[$self->{"completion"}->{"index"}]; | |||||||||||||||||||||||||||
| 498 | |||||||||||||||||||||||||||||
| 499 | 0 | ▶ | return unless (defined($match)); | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 500 | |||||||||||||||||||||||||||||
| 501 | #$self->out("Match: $match / " . $self->{"completion"}->{"index"} . " / " . @matches); | ||||||||||||||||||||||||||||
| 502 | |||||||||||||||||||||||||||||
| 503 | 0 | $self->{"completion"}->{"index"}++; | |||||||||||||||||||||||||||
| 504 | 0 | ▶ | $self->{"completion"}->{"index"} = 0 if ($self->{"completion"}->{"index"} == scalar(@matches)); | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 505 | |||||||||||||||||||||||||||||
| 506 | 0 | substr($line, $bword, $pos - $bword) = $match; | |||||||||||||||||||||||||||
| 507 | |||||||||||||||||||||||||||||
| 508 | 0 | $self->{"completion"}->{"endpos"} = $pos; | |||||||||||||||||||||||||||
| 509 | |||||||||||||||||||||||||||||
| 510 | 0 | $pos = $bword + length($match); | |||||||||||||||||||||||||||
| 511 | 0 | $self->{"input_position"} = $pos; | |||||||||||||||||||||||||||
| 512 | 0 | $self->{"input_line"} = $line; | |||||||||||||||||||||||||||
| 513 | |||||||||||||||||||||||||||||
| 514 | 0 | $self->fix_inputline(); | |||||||||||||||||||||||||||
| 515 | |||||||||||||||||||||||||||||
| 516 | } | ||||||||||||||||||||||||||||
| 517 | } | ||||||||||||||||||||||||||||
| 518 | |||||||||||||||||||||||||||||
| 519 | |||||||||||||||||||||||||||||
| 520 | # -------------------------------------------------------------------- | ||||||||||||||||||||||||||||
| 521 | # Helper functions | ||||||||||||||||||||||||||||
| 522 | |||||||||||||||||||||||||||||
| 523 | # Go from a position and find the beginning of the word we're on. | ||||||||||||||||||||||||||||
| 524 | 0 | ▶ | sub find_word_bound ($$$;$) { | ||||||||||||||||||||||||||
|
Subroutine
find_word_bound: not called CC=10 SCAR=47.0
Pod
undocumented
| |||||||||||||||||||||||||||||
| 525 | 0 | my $self = shift; | |||||||||||||||||||||||||||
| 526 | 0 | my $line = shift; | |||||||||||||||||||||||||||
| 527 | 0 | my $pos = shift; | |||||||||||||||||||||||||||
| 528 | 0 | ▶ | my $opts = shift || 0; | ||||||||||||||||||||||||||
|
Condition0%0/2
shift() || 0
MC/DC0%0/1
shift() || 0
shift()
Truth table0%0/2
A
A= shift()
| |||||||||||||||||||||||||||||
| 529 | 0 | my $regex = "[A-Za-z0-9]"; | |||||||||||||||||||||||||||
| 530 | 0 | my $bword; | |||||||||||||||||||||||||||
| 531 | |||||||||||||||||||||||||||||
| 532 | 0 | ▶ | $regex = shift if ($opts & WORD_REGEX); | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 533 | |||||||||||||||||||||||||||||
| 534 | # Mod? This is either -1 or +1 depending on if we're looking behind or | ||||||||||||||||||||||||||||
| 535 | # if we're looking ahead. | ||||||||||||||||||||||||||||
| 536 | 0 | my $mod = -1; | |||||||||||||||||||||||||||
| 537 | 0 | ▶ | $mod = 1 if ($opts & WORD_END); | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 538 | |||||||||||||||||||||||||||||
| 539 | # What are we doing? | ||||||||||||||||||||||||||||
| 540 | # If we're in a word, go to the beginning of the word | ||||||||||||||||||||||||||||
| 541 | # If we're on a space, go to end of previous word. | ||||||||||||||||||||||||||||
| 542 | # If we're on a nonspace/nonword, go to beginning of nonword chars | ||||||||||||||||||||||||||||
| 543 | |||||||||||||||||||||||||||||
| 544 | 0 | $bword = $pos - 1; | |||||||||||||||||||||||||||
| 545 | |||||||||||||||||||||||||||||
| 546 | # If we're at the end of the string, ignore all trailing whitespace. | ||||||||||||||||||||||||||||
| 547 | # unless WORD_ONLY is set. | ||||||||||||||||||||||||||||
| 548 | #out(" | ||||||||||||||||||||||||||||
| 549 | 0 | ▶ | if (($bword + 1 == $pos) && (! $opts & WORD_ONLY)) { | ||||||||||||||||||||||||||
|
Branch: 1 branch
Condition0%0/3
$bword + 1 == $pos and !$opts & 2
MC/DC0%0/2
$bword + 1 == $pos and !$opts & 2
$bword + 1 == $pos
!$opts & 2
Truth table0%0/3
A and not(B)
A= $bword + 1 == $posB= !$opts & 2
| |||||||||||||||||||||||||||||
| 550 | 0 | ▶ | $bword += $mod while (substr($line,$bword,1) =~ m/^\s$/); | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 551 | } | ||||||||||||||||||||||||||||
| 552 | |||||||||||||||||||||||||||||
| 553 | # If we're not on an ALPHANUM, then we want to reverse the match. | ||||||||||||||||||||||||||||
| 554 | # that is, if we are: | ||||||||||||||||||||||||||||
| 555 | # "testing here hello .......there" | ||||||||||||||||||||||||||||
| 556 | # ^-- here | ||||||||||||||||||||||||||||
| 557 | # Then we want to delete (match) all the periods (nonalphanums) | ||||||||||||||||||||||||||||
| 558 | 0 | ▶ | substr($regex, 1, 0) = "^" if (substr($line,$bword,1) !~ m/$regex/); | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 559 | |||||||||||||||||||||||||||||
| 560 | # Back up until we hit the end of our "word" | ||||||||||||||||||||||||||||
| 561 | 0 | ▶ | $bword += $mod while (substr($line,$bword,1) =~ m/$regex/ && $bword >= 0); | ||||||||||||||||||||||||||
|
Branch: 1 branch
Condition0%0/3
substr($line, $bword, 1) =~ /$regex/ and $bword >= 0
MC/DC0%0/2
substr($line, $bword, 1) =~ /$regex/ and $bword >= 0
substr($line, $bword, 1) =~ /$regex/
$bword >= 0
Truth table0%0/3
A and B
A= substr($line, $bword, 1) =~ /$regex/B= $bword >= 0
| |||||||||||||||||||||||||||||
| 562 | |||||||||||||||||||||||||||||
| 563 | # Whoops, one too far... | ||||||||||||||||||||||||||||
| 564 | 0 | $bword -= $mod; | |||||||||||||||||||||||||||
| 565 | |||||||||||||||||||||||||||||
| 566 | 0 | return $bword; | |||||||||||||||||||||||||||
| 567 | } | ||||||||||||||||||||||||||||
| 568 | |||||||||||||||||||||||||||||
| 569 | =pod | ||||||||||||||||||||||||||||
| 570 | |||||||||||||||||||||||||||||
| 571 | =back | ||||||||||||||||||||||||||||
| 572 | |||||||||||||||||||||||||||||
| 573 | =cut | ||||||||||||||||||||||||||||
| 574 | |||||||||||||||||||||||||||||
| 575 | 1 | 1; | |||||||||||||||||||||||||||