ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/rxvt-unicode/src/perl/matcher
(Generate patch)

Comparing rxvt-unicode/src/perl/matcher (file contents):
Revision 1.7 by sf-tpope, Tue Aug 30 20:02:32 2011 UTC vs.
Revision 1.23 by sf-exg, Thu Jun 12 12:19:09 2014 UTC

1#! perl 1#! perl
2 2
3# Author: Tim Pope <rxvt-unicodeNOSPAM@tpope.org> 3# Author: Tim Pope <rxvt-unicodeNOSPAM@tpope.org>
4# Bob Farrell <robertanthonyfarrell@gmail.com> 4# Bob Farrell <robertanthonyfarrell@gmail.com>
5
6#:META:RESOURCE:%.launcher:string:default launcher command
7#:META:RESOURCE:%.button:string:the button, yeah
8#:META:RESOURCE:%.pattern.:string:extra pattern to match
9#:META:RESOURCE:%.launcher.:string:custom launcher for pattern
10#:META:RESOURCE:%.rend.:string:custom rednition for pattern
11
12=head1 NAME
13
14matcher - match strings in terminal output and change their rendition
15
16=head1 DESCRIPTION
17
18Uses per-line display filtering (C<on_line_update>) to underline text
19matching a certain pattern and make it clickable. When clicked with the
20mouse button specified in the C<matcher.button> resource (default 2, or
21middle), the program specified in the C<matcher.launcher> resource
22(default, the C<url-launcher> resource, C<sensible-browser>) will be started
23with the matched text as first argument. The default configuration is
24suitable for matching URLs and launching a web browser, like the
25former "mark-urls" extension.
26
27The default pattern to match URLs can be overridden with the
28C<matcher.pattern.0> resource, and additional patterns can be specified
29with numbered patterns, in a manner similar to the "selection" extension.
30The launcher can also be overridden on a per-pattern basis.
31
32It is possible to activate the most recently seen match or a list of matches
33from the keyboard. Simply bind a keysym to "matcher:last" or
34"matcher:list" as seen in the example below.
35
36Example: load and use the matcher extension with defaults.
37
38 URxvt.perl-ext: default,matcher
39
40Example: use a custom configuration.
41
42 URxvt.url-launcher: sensible-browser
43 URxvt.keysym.C-Delete: matcher:last
44 URxvt.keysym.M-Delete: matcher:list
45 URxvt.matcher.button: 1
46 URxvt.matcher.pattern.1: \\bwww\\.[\\w-]+\\.[\\w./?&@#-]*[\\w/-]
47 URxvt.matcher.pattern.2: \\B(/\\S+?):(\\d+)(?=:|$)
48 URxvt.matcher.launcher.2: gvim +$2 $1
49
50=cut
5 51
6my $url = 52my $url =
7 qr{ 53 qr{
8 (?:https?://|ftp://|news://|mailto:|file://|\bwww\.) 54 (?:https?://|ftp://|news://|mailto:|file://|\bwww\.)
9 [a-zA-Z0-9\-\@;\/?:&=%\$_.+!*\x27,~#]* 55 [\w\-\@;\/?:&=%\$.+!*\x27,~#]*
10 ( 56 (
11 \([a-zA-Z0-9\-\@;\/?:&=%\$_.+!*\x27,~#]*\)| # Allow a pair of matched parentheses 57 \([\w\-\@;\/?:&=%\$.+!*\x27,~#]*\)| # Allow a pair of matched parentheses
12 [a-zA-Z0-9\-\@;\/?:&=%\$_+*~] # exclude some trailing characters (heuristic) 58 [\w\-\@;\/?:&=%\$+*~] # exclude some trailing characters (heuristic)
13 )+ 59 )+
14 }x; 60 }x;
15 61
16sub on_key_press { 62sub on_key_press {
17 my ($self, $event, $keysym, $octets) = @_; 63 my ($self, $event, $keysym, $octets) = @_;
18 64
19 if (! $self->{showing} ) { 65 return unless $self->{overlay};
20 return; 66
21 } 67 delete $self->{overlay};
22 68
23 my $i = ($keysym == 96 ? 0 : $keysym - 48); 69 my $i = ($keysym == 96 ? 0 : $keysym - 48);
24 if (($i > scalar(@{$self->{urls}})) || ($i < 0)) { 70 if ($i >= 0 && $i < @{ $self->{matches} }) {
25 $self->matchlist(); 71 my @exec = @{ $self->{matches}[$i] };
26 return; 72 shift @exec;
73 $self->exec_async (@exec);
74 }
75
27 } 76 1
28
29 my @args = ($self->{urls}[ -$i-1 ]);
30 $self->matchlist();
31
32 $self->exec_async( $self->{launcher}, @args );
33} 77}
34 78
79# backwards compat
35sub on_user_command { 80sub on_user_command {
36 my ($self, $cmd) = @_; 81 my ($self, $cmd) = @_;
37 82
38 if($cmd =~ s/^matcher:list\b//) { 83 if ($cmd =~ s/^matcher:list\b//) {
39 $self->matchlist(); 84 $self->matchlist;
40 } else { 85 } else {
41 if($cmd =~ s/^matcher:last\b//) { 86 if ($cmd =~ s/^matcher:last\b//) {
42 $self->most_recent; 87 $self->most_recent;
43 }
44 # For backward compatibility
45 else {
46 if($cmd =~ s/^matcher\b//) { 88 } elsif ($cmd =~ s/^matcher\b//) {
89 # for backward compatibility
47 $self->most_recent; 90 $self->most_recent;
48 } 91 }
49 } 92 }
93
94 ()
95}
96
97sub on_action {
98 my ($self, $action) = @_;
99
100 if ($action eq "list") {
101 $self->matchlist;
102 } elsif ($action eq "last") {
103 $self->most_recent;
50 } 104 }
105
51 () 106 ()
52} 107}
53 108
54sub matchlist { 109sub matchlist {
55 my ($self) = @_; 110 my ($self) = @_;
56 if ( $self->{showing} ) { 111
57 $self->{url_overlay}->hide();
58 $self->{showing} = 0;
59 return;
60 }
61 @{$self->{urls}} = (); 112 @{ $self->{matches} } = ();
62 my $line; 113 my $row = $self->nrow - 1;
63 for (my $i = 0; $i < $self->nrow; $i ++) { 114 while ($row >= 0 && @{ $self->{matches} } < 10) {
64 $line = $self->line($i); 115 my $line = $self->line ($row);
65 next if ($line->beg != $i); 116 my @matches = $self->find_matches ($row, 0);
66 for my $url ($self->get_urls_from_line($line->t)) { 117
67 if (scalar(@{$self->{urls}}) == 10) { 118 for (sort { $b->[0] <=> $a->[0] } @matches) {
68 shift @{$self->{urls}}; 119 shift @$_;
69 }
70 push @{$self->{urls}}, $url; 120 push @{ $self->{matches} }, $_;
121 last if @{ $self->{matches} } == 10;
71 } 122 }
123
124 $row = $line->beg - 1;
72 } 125 }
73 126
74 if (! scalar(@{$self->{urls}})) { 127 return unless @{ $self->{matches} };
75 return;
76 }
77 128
78 my $max = 0; 129 my $width = 0;
79 my $i = scalar( @{$self->{urls}} ) - 1 ;;
80 130
81 my @temp = ();
82
83 for my $url (@{$self->{urls}}) {
84 my $url = "$i-$url";
85 my $xpos = 0;
86
87 if ($self->ncol + (length $url) >= $self->ncol) {
88 $url = substr( $url, 0, $self->ncol );
89 }
90
91 push @temp, $url;
92
93 if( length $url > $max ) {
94 $max = length $url;
95 }
96
97 $i--;
98 }
99
100 @temp = reverse @temp;
101
102 $self->{url_overlay} = $self->overlay(0, 0, $max, scalar( @temp ), urxvt::OVERLAY_RSTYLE, 2);
103 my $i = 0; 131 my $i = 0;
104 for my $url (@temp) { 132 for my $match (@{ $self->{matches} }) {
105 $self->{url_overlay}->set( 0, $i, $url, [(urxvt::OVERLAY_RSTYLE) x length $url]); 133 my $text = $match->[0];
106 $self->{showing} = 1; 134 my $w = $self->strwidth ("$i-$text");
135
136 $width = $w if $w > $width;
107 $i++; 137 $i++;
108 } 138 }
139
140 $width = $self->ncol - 2 if $width > $self->ncol - 2;
141
142 $self->{overlay} = $self->overlay (0, 0, $width, scalar (@{ $self->{matches} }), urxvt::OVERLAY_RSTYLE, 2);
143 my $i = 0;
144 for my $match (@{ $self->{matches} }) {
145 my $text = $match->[0];
146
147 $self->{overlay}->set (0, $i, "$i-$text");
148 $i++;
149 }
109 150
110} 151}
111 152
112sub most_recent { 153sub most_recent {
113 my ($self) = shift; 154 my ($self) = shift;
122 } 163 }
123 () 164 ()
124} 165}
125 166
126sub my_resource { 167sub my_resource {
127 my $self = shift; 168 $_[0]->x_resource ("%.$_[1]")
128 $self->x_resource ("$self->{name}.$_[0]");
129} 169}
130 170
131# turn a rendition spec in the resource into a sub that implements it on $_ 171# turn a rendition spec in the resource into a sub that implements it on $_
132sub parse_rend { 172sub parse_rend {
133 my ($self, $str) = @_; 173 my ($self, $str) = @_;
144} 184}
145 185
146sub on_start { 186sub on_start {
147 my ($self) = @_; 187 my ($self) = @_;
148 188
149 ($self->{name} = __PACKAGE__) =~ s/.*:://; 189 $self->{launcher} = $self->my_resource ("launcher") || $self->x_resource("url-launcher") || "sensible-browser";
150 $self->{name} =~ tr/_/-/;
151 $self->{launcher} = $self->my_resource("launcher") ||
152 $self->x_resource("urlLauncher") ||
153 "sensible-browser";
154 190
155 $self->{urls} = []; 191 $self->{matches} = [];
156 $self->{showing} = 0;
157 $self->{button} = 2; 192 $self->{button} = 2;
158 $self->{state} = 0; 193 $self->{state} = 0;
159 if($self->{argv}[0] || $self->my_resource("button")) { 194 if($self->{argv}[0] || $self->my_resource ("button")) {
160 my @mods = split('', $self->{argv}[0] || $self->my_resource("button")); 195 my @mods = split '', $self->{argv}[0] || $self->my_resource ("button");
161 for my $mod (@mods) { 196 for my $mod (@mods) {
162 if($mod =~ /^\d+$/) { 197 if($mod =~ /^\d+$/) {
163 $self->{button} = $mod; 198 $self->{button} = $mod;
164 } elsif($mod eq "C") { 199 } elsif($mod eq "C") {
165 $self->{state} |= urxvt::ControlMask; 200 $self->{state} |= urxvt::ControlMask;
166 } elsif($mod eq "S") { 201 } elsif($mod eq "S") {
167 $self->{state} |= urxvt::ShiftMask; 202 $self->{state} |= urxvt::ShiftMask;
168 } elsif($mod eq "M") { 203 } elsif($mod eq "M") {
169 $self->{state} |= $self->ModMetaMask; 204 $self->{state} |= $self->ModMetaMask;
170 } elsif($mod ne "-" && $mod ne " ") { 205 } elsif($mod ne "-" && $mod ne " ") {
171 warn("$mod is invalid in $self->{name}<$self->{argv}[0]>\n"); 206 warn("$mod is invalid in $self->{_name}<$self->{argv}[0]>\n");
172 } 207 }
173 } 208 }
174 } 209 }
175 210
176 my @defaults = ($url); 211 my @defaults = ($url);
177 my @matchers; 212 my @matchers;
178 for (my $idx = 0; defined (my $res = $self->my_resource("pattern.$idx") || $defaults[$idx]); $idx++) { 213 for (my $idx = 0; defined (my $res = $self->my_resource ("pattern.$idx") || $defaults[$idx]); $idx++) {
179 $res = $self->locale_decode ($res); 214 $res = $self->locale_decode ($res);
180 utf8::encode $res; 215 utf8::encode $res;
181 my $launcher = $self->my_resource("launcher.$idx"); 216 my $launcher = $self->my_resource ("launcher.$idx");
182 $launcher =~ s/\$&|\$\{&\}/\${0}/g if ($launcher); 217 $launcher =~ s/\$&|\$\{&\}/\${0}/g if $launcher;
183 my $rend = $self->parse_rend($self->my_resource("rend.$idx")); 218 my $rend = $self->parse_rend($self->my_resource ("rend.$idx"));
184 unshift @matchers, [qr($res)x,$launcher,$rend]; 219 unshift @matchers, [qr($res)x,$launcher,$rend];
185 } 220 }
186 $self->{matchers} = \@matchers; 221 $self->{matchers} = \@matchers;
187 222
188 () 223 ()
189}
190
191sub get_urls_from_line {
192 my ($self, $line) = @_;
193 my @urls;
194 for my $matcher (@{$self->{matchers}}) {
195 while ($line =~ /$matcher->[0]/g) {
196 push @urls, substr( $line, $-[0], $+[0] - $-[0] );
197 }
198 }
199 return @urls;
200} 224}
201 225
202sub on_line_update { 226sub on_line_update {
203 my ($self, $row) = @_; 227 my ($self, $row) = @_;
204 228
231 | urxvt::ShiftMask | urxvt::ControlMask; 255 | urxvt::ShiftMask | urxvt::ControlMask;
232 return ($event->{button} == $self->{button} && 256 return ($event->{button} == $self->{button} &&
233 ($event->{state} & $mask) == $self->{state}); 257 ($event->{state} & $mask) == $self->{state});
234} 258}
235 259
236sub command_for { 260sub find_matches {
237 my ($self, $row, $col) = @_; 261 my ($self, $row, $col) = @_;
238 my $line = $self->line ($row); 262 my $line = $self->line ($row);
239 my $text = $line->t; 263 my $text = $line->t;
240 264
265 my @matches;
241 for my $matcher (@{$self->{matchers}}) { 266 for my $matcher (@{$self->{matchers}}) {
242 my $launcher = $matcher->[1] || $self->{launcher}; 267 my $launcher = $matcher->[1] || $self->{launcher};
243 while (($text =~ /$matcher->[0]/g)) { 268 while ($text =~ /$matcher->[0]/g) {
244 my $match = $&; 269 my $match = substr $text, $-[0], $+[0] - $-[0];
245 my @begin = @-; 270 my @begin = @-;
246 my @end = @+; 271 my @end = @+;
272 my @exec;
273
247 if (!defined($col) || ($-[0] <= $col && $+[0] >= $col)) { 274 if (!defined($col) || ($-[0] <= $col && $+[0] >= $col)) {
248 if ($launcher !~ /\$/) { 275 if ($launcher !~ /\$/) {
249 return ($launcher,$match); 276 @exec = ($launcher, $match);
250 } else { 277 } else {
251 # It'd be nice to just access a list like ($&,$1,$2...), 278 # It'd be nice to just access a list like ($&,$1,$2...),
252 # but alas, m//g behaves differently in list context. 279 # but alas, m//g behaves differently in list context.
253 my @exec = map { s/\$(\d+)|\$\{(\d+)\}/ 280 @exec = map { s/\$(\d+)|\$\{(\d+)\}/
254 substr($text,$begin[$1||$2],$end[$1||$2]-$begin[$1||$2]) 281 substr $text, $begin[$1 || $2], $end[$1 || $2] - $begin[$1 || $2]
255 /egx; $_ } split(/\s+/, $launcher); 282 /egx; $_ } split /\s+/, $launcher;
256 return @exec;
257 } 283 }
284
285 push @matches, [ $begin[0], $match, @exec ];
258 } 286 }
259 } 287 }
288 }
289
290 @matches;
291}
292
293sub command_for {
294 my ($self, $row, $col) = @_;
295
296 my @matches = $self->find_matches ($row, $col);
297 if (@matches) {
298 my @match = @{ $matches[0] };
299 return @match[2 .. $#match];
260 } 300 }
261 301
262 () 302 ()
263} 303}
264 304
290 330
291 if($row == $event->{row} && abs($col-$event->{col}) < 2 331 if($row == $event->{row} && abs($col-$event->{col}) < 2
292 && join("\x00", @$cmd) eq join("\x00", $self->command_for($row,$col))) { 332 && join("\x00", @$cmd) eq join("\x00", $self->command_for($row,$col))) {
293 if($self->valid_button($event)) { 333 if($self->valid_button($event)) {
294 334
295 $self->exec_async (@$cmd); 335 $self->exec_async (@$cmd);
296 336
297 } 337 }
298 } 338 }
299 339
300 1; 340 1;

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines