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

Comparing rxvt-unicode/src/urxvt.pm (file contents):
Revision 1.52 by root, Sun Jan 8 00:48:14 2006 UTC vs.
Revision 1.59 by root, Mon Jan 9 00:34:36 2006 UTC

37 37
38 @@RXVT_NAME@@ -pe <extensionname> 38 @@RXVT_NAME@@ -pe <extensionname>
39 39
40=over 4 40=over 4
41 41
42=item selection 42=item selection (enabled by default)
43 43
44Intelligent selection. This extension tries to be more intelligent when 44Intelligent selection. This extension tries to be more intelligent when
45the user extends selections (double-click). Right now, it tries to select 45the user extends selections (double-click). Right now, it tries to select
46urls and complete shell-quoted arguments, which is very convenient, too, 46urls and complete shell-quoted arguments, which is very convenient, too,
47if your F<ls> supports C<--quoting-style=shell>. 47if your F<ls> supports C<--quoting-style=shell>.
55Rot-13 the selection when activated. Used via keyboard trigger: 55Rot-13 the selection when activated. Used via keyboard trigger:
56 56
57 URxvt.keysym.C-M-r: perl:selection:rot13 57 URxvt.keysym.C-M-r: perl:selection:rot13
58 58
59=back 59=back
60
61=item option-popup (enabled by default)
62
63Binds a popup menu to Ctrl-Button2 that lets you toggle (some) options at
64runtime.
65
66=item selection-popup (enabled by default)
67
68Binds a popup menu to Ctrl-Button3 that lets you convert the selection
69text into various other formats/action.
60 70
61=item digital-clock 71=item digital-clock
62 72
63Displays a digital clock using the built-in overlay. 73Displays a digital clock using the built-in overlay.
64 74
337 347
338=item urxvt::ShiftMask, LockMask, ControlMask, Mod1Mask, Mod2Mask, 348=item urxvt::ShiftMask, LockMask, ControlMask, Mod1Mask, Mod2Mask,
339Mod3Mask, Mod4Mask, Mod5Mask, Button1Mask, Button2Mask, Button3Mask, 349Mod3Mask, Mod4Mask, Mod5Mask, Button1Mask, Button2Mask, Button3Mask,
340Button4Mask, Button5Mask, AnyModifier 350Button4Mask, Button5Mask, AnyModifier
341 351
342Various constants for use in X events. 352Various constants for use in X calls and event processing.
343 353
344=back 354=back
345 355
346=head2 RENDITION 356=head2 RENDITION
347 357
402use utf8; 412use utf8;
403use strict; 413use strict;
404use Scalar::Util (); 414use Scalar::Util ();
405use List::Util (); 415use List::Util ();
406 416
417our $VERSION = 1;
407our $TERM; 418our $TERM;
408our @HOOKNAME; 419our @HOOKNAME;
409our %OPTION; 420our %OPTION;
410our $LIBDIR; 421our $LIBDIR;
411 422
417 my $msg = join "", @_; 428 my $msg = join "", @_;
418 $msg .= "\n" 429 $msg .= "\n"
419 unless $msg =~ /\n$/; 430 unless $msg =~ /\n$/;
420 urxvt::warn ($msg); 431 urxvt::warn ($msg);
421 }; 432 };
433
434 $ENV{PATH} = "/bin:/sbin:/usr/bin:/usr/sbin:/usr/local/bin:/usr/local/sbin:/opt/bin:/opt/sbin";
435 delete $ENV{CDPATH};
422} 436}
423 437
424my @hook_count; 438my @hook_count;
425my $verbosity = $ENV{URXVT_PERL_VERBOSITY}; 439my $verbosity = $ENV{URXVT_PERL_VERBOSITY};
426 440
459 verbose 3, "loading extension '$path' into package '$pkg'"; 473 verbose 3, "loading extension '$path' into package '$pkg'";
460 474
461 open my $fh, "<:raw", $path 475 open my $fh, "<:raw", $path
462 or die "$path: $!"; 476 or die "$path: $!";
463 477
464 my $source = "package $pkg; use strict; use utf8;\n" 478 my $source = untaint "package $pkg; use strict; use utf8;\n"
465 . "use base urxvt::term::proxy::;\n" 479 . "use base urxvt::term::proxy::;\n"
466 . "#line 1 \"$path\"\n{\n" 480 . "#line 1 \"$path\"\n{\n"
467 . (do { local $/; <$fh> }) 481 . (do { local $/; <$fh> })
468 . "\n};\n1"; 482 . "\n};\n1";
469 483
485 499
486 my %want_ext; 500 my %want_ext;
487 501
488 for (map { split /,/, $TERM->resource ("perl_ext_$_") } 1, 2) { 502 for (map { split /,/, $TERM->resource ("perl_ext_$_") } 1, 2) {
489 if ($_ eq "default") { 503 if ($_ eq "default") {
490 $want_ext{$_}++ for qw(selection option-popup); 504 $want_ext{$_}++ for qw(selection option-popup selection-popup);
491 } elsif (/^-(.*)$/) { 505 } elsif (/^-(.*)$/) {
492 delete $want_ext{$1}; 506 delete $want_ext{$1};
493 } else { 507 } else {
494 $want_ext{$_}++; 508 $want_ext{$_}++;
495 } 509 }
502 register_package extension_package $files[0]; 516 register_package extension_package $files[0];
503 } else { 517 } else {
504 warn "perl extension '$ext' not found in perl library search path\n"; 518 warn "perl extension '$ext' not found in perl library search path\n";
505 } 519 }
506 } 520 }
521
522 eval "#line 1 \"--perl-eval resource/argument\"\n" . $TERM->resource ("perl_eval");
523 warn $@ if $@;
507 } 524 }
508 525
509 $retval = undef; 526 $retval = undef;
510 527
511 if (my $cb = $TERM->{_hook}[$htype]) { 528 if (my $cb = $TERM->{_hook}[$htype]) {
523 $proxy 540 $proxy
524 }, 541 },
525 @_, 542 @_,
526 ) and last; 543 ) and last;
527 }; 544 };
528 warn $@ if $@;#d# 545 if ($@) {
546 $TERM->ungrab; # better to lose the grab than the session
547 warn $@;
548 }
529 } 549 }
530 } 550 }
531 551
532 if ($htype == 1) { # DESTROY 552 if ($htype == 1) { # DESTROY
533 # remove hooks if unused 553 # remove hooks if unused
546 } 566 }
547 567
548 $retval 568 $retval
549} 569}
550 570
571# urxvt::term::proxy
572
551sub urxvt::term::proxy::AUTOLOAD { 573sub urxvt::term::proxy::AUTOLOAD {
552 $urxvt::term::proxy::AUTOLOAD =~ /:([^:]+)$/ 574 $urxvt::term::proxy::AUTOLOAD =~ /:([^:]+)$/
553 or die "FATAL: \$AUTOLOAD '$urxvt::term::proxy::AUTOLOAD' unparsable"; 575 or die "FATAL: \$AUTOLOAD '$urxvt::term::proxy::AUTOLOAD' unparsable";
554 576
555 eval qq{ 577 eval qq{
561 } or die "FATAL: unable to compile method forwarder: $@"; 583 } or die "FATAL: unable to compile method forwarder: $@";
562 584
563 goto &$urxvt::term::proxy::AUTOLOAD; 585 goto &$urxvt::term::proxy::AUTOLOAD;
564} 586}
565 587
588sub urxvt::term::proxy::DESTROY {
589 # nop
590}
591
592# urxvt::destroy_hook
593
566sub urxvt::destroy_hook::DESTROY { 594sub urxvt::destroy_hook::DESTROY {
567 ${$_[0]}->(); 595 ${$_[0]}->();
568} 596}
569 597
570sub urxvt::destroy_hook(&) { 598sub urxvt::destroy_hook(&) {
571 bless \shift, urxvt::destroy_hook:: 599 bless \shift, urxvt::destroy_hook::
572} 600}
601
602package urxvt::anyevent;
603
604=head2 The C<urxvt::anyevent> Class
605
606The sole purpose of this class is to deliver an interface to the
607C<AnyEvent> module - any module using it will work inside urxvt without
608further work. The only exception is that you cannot wait on condition
609variables, but non-blocking condvar use is ok. What this means is that you
610cannot use blocking APIs, but the non-blocking variant should work.
611
612=cut
613
614our $VERSION = 1;
615
616$INC{"urxvt/anyevent.pm"} = 1; # mark us as there
617push @AnyEvent::REGISTRY, [urxvt => urxvt::anyevent::];
618
619sub timer {
620 my ($class, %arg) = @_;
621
622 my $cb = $arg{cb};
623
624 urxvt::timer
625 ->new
626 ->start (urxvt::NOW + $arg{after})
627 ->cb (sub {
628 $_[0]->stop; # need to cancel manually
629 $cb->();
630 })
631}
632
633sub io {
634 my ($class, %arg) = @_;
635
636 my $cb = $arg{cb};
637
638 bless [$arg{fh}, urxvt::iow
639 ->new
640 ->fd (fileno $arg{fh})
641 ->events (($arg{poll} =~ /r/ ? 1 : 0)
642 | ($arg{poll} =~ /w/ ? 2 : 0))
643 ->start
644 ->cb (sub {
645 $cb->(($_[1] & 1 ? 'r' : '')
646 . ($_[1] & 2 ? 'w' : ''));
647 })],
648 urxvt::anyevent::
649}
650
651sub DESTROY {
652 $_[0][1]->stop;
653}
654
655sub condvar {
656 bless \my $flag, urxvt::anyevent::condvar::
657}
658
659sub urxvt::anyevent::condvar::broadcast {
660 ${$_[0]}++;
661}
662
663sub urxvt::anyevent::condvar::wait {
664 unless (${$_[0]}) {
665 require Carp;
666 Carp::croak ("AnyEvent->condvar blocking wait unsupported in urxvt, use a non-blocking API");
667 }
668}
669
670package urxvt::term;
573 671
574=head2 The C<urxvt::term> Class 672=head2 The C<urxvt::term> Class
575 673
576=over 4 674=over 4
577 675
629 shade term_name title transparent transparent_all tripleclickwords 727 shade term_name title transparent transparent_all tripleclickwords
630 utmpInhibit visualBell 728 utmpInhibit visualBell
631 729
632=cut 730=cut
633 731
634sub urxvt::term::resource($$;$) { 732sub resource($$;$) {
635 my ($self, $name) = (shift, shift); 733 my ($self, $name) = (shift, shift);
636 unshift @_, $self, $name, ($name =~ s/\s*\+\s*(\d+)$// ? $1 : 0); 734 unshift @_, $self, $name, ($name =~ s/\s*\+\s*(\d+)$// ? $1 : 0);
637 &urxvt::term::_resource 735 &urxvt::term::_resource
638} 736}
639 737
726C<$event> I<must> be the event causing the menu to pop up (a button event, 824C<$event> I<must> be the event causing the menu to pop up (a button event,
727currently). 825currently).
728 826
729=cut 827=cut
730 828
731sub urxvt::term::popup { 829sub popup {
732 my ($self, $event) = @_; 830 my ($self, $event) = @_;
733 831
734 $self->grab ($event->{time}, 1) 832 $self->grab ($event->{time}, 1)
735 or return; 833 or return;
736 834
926 1024
927=back 1025=back
928 1026
929=cut 1027=cut
930 1028
931sub urxvt::term::line { 1029sub line {
932 my ($self, $row) = @_; 1030 my ($self, $row) = @_;
933 1031
934 my $maxrow = $self->nrow - 1; 1032 my $maxrow = $self->nrow - 1;
935 1033
936 my ($beg, $end) = ($row, $row); 1034 my ($beg, $end) = ($row, $row);
1014Converts rxvt-unicodes text reprsentation into a perl string. See 1112Converts rxvt-unicodes text reprsentation into a perl string. See
1015C<< $term->ROW_t >> for details. 1113C<< $term->ROW_t >> for details.
1016 1114
1017=back 1115=back
1018 1116
1117=cut
1118
1119package urxvt::popup;
1120
1019=head2 The C<urxvt::popup> Class 1121=head2 The C<urxvt::popup> Class
1020 1122
1021=over 4 1123=over 4
1022 1124
1023=cut 1125=cut
1024
1025package urxvt::popup;
1026 1126
1027sub add_item { 1127sub add_item {
1028 my ($self, $item) = @_; 1128 my ($self, $item) = @_;
1029 1129
1130 $item->{rend}{normal} = "\x1b[0;30;47m" unless exists $item->{rend}{normal};
1131 $item->{rend}{hover} = "\x1b[0;30;46m" unless exists $item->{rend}{hover};
1132 $item->{rend}{active} = "\x1b[m" unless exists $item->{rend}{active};
1133
1134 $item->{render} ||= sub { $_[0]{text} };
1135
1030 push @{ $self->{item} }, $item; 1136 push @{ $self->{item} }, $item;
1137}
1138
1139sub add_separator {
1140 my ($self, $sep) = @_;
1141
1142 $sep ||= "═";
1143
1144 $self->add_item ({
1145 rend => { normal => "\x1b[0;30;47m", hover => "\x1b[0;30;47m", active => "\x1b[0;30;47m" },
1146 text => "",
1147 render => sub { $sep x $urxvt::TERM->ncol },
1148 activate => sub { },
1149 });
1150}
1151
1152sub add_title {
1153 my ($self, $title) = @_;
1154
1155 $self->add_item ({
1156 rend => { normal => "\x1b[38;5;11;44m", hover => "\x1b[38;5;11;44m", active => "\x1b[38;5;11;44m" },
1157 text => $title,
1158 activate => sub { },
1159 });
1031} 1160}
1032 1161
1033sub add_button { 1162sub add_button {
1034 my ($self, $text, $cb) = @_; 1163 my ($self, $text, $cb) = @_;
1035 1164
1036 $self->add_item ({ type => "button", text => "[ $text ]", activate => $cb, 1165 $self->add_item ({ type => "button", text => "[ $text ]", activate => $cb});
1037 render => sub { $_[0]{text} },
1038 });
1039} 1166}
1040 1167
1041sub add_toggle { 1168sub add_toggle {
1042 my ($self, $text, $cb, $value) = @_; 1169 my ($self, $text, $cb, $value) = @_;
1043 1170
1044 my $item; $item = { 1171 my $item; $item = {
1045 type => "button", 1172 type => "button",
1046 text => " $text", 1173 text => " $text",
1047 value => $value, 1174 value => $value,
1048 render => sub { ($item->{value} ? "* " : " ") . $text }, 1175 render => sub { ($_[0]{value} ? "* " : " ") . $text },
1049 activate => sub { $cb->($item->{value} = !$item->{value}); }, 1176 activate => sub { $cb->($_[0]{value} = !$_[0]{value}); },
1050 }; 1177 };
1051 1178
1052 $self->add_item ($item); 1179 $self->add_item ($item);
1053} 1180}
1054 1181
1064} 1191}
1065 1192
1066sub DESTROY { 1193sub DESTROY {
1067 my ($self) = @_; 1194 my ($self) = @_;
1068 1195
1196 delete $self->{term}{_destroy}{$self};
1069 $self->{term}->ungrab; 1197 $self->{term}->ungrab;
1070} 1198}
1071 1199
1072=head2 The C<urxvt::timer> Class 1200=head2 The C<urxvt::timer> Class
1073 1201
1177This variable controls the verbosity level of the perl extension. Higher 1305This variable controls the verbosity level of the perl extension. Higher
1178numbers indicate more verbose output. 1306numbers indicate more verbose output.
1179 1307
1180=over 4 1308=over 4
1181 1309
1182=item =0 - only fatal messages 1310=item == 0 - fatal messages
1183 1311
1184=item =3 - script loading and management 1312=item >= 3 - script loading and management
1185 1313
1186=item =10 - all events received 1314=item >=10 - all events received
1187 1315
1188=back 1316=back
1189 1317
1190=head1 AUTHOR 1318=head1 AUTHOR
1191 1319

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines