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.49 by root, Sun Jan 8 00:07:18 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
481 my $htype = shift; 495 my $htype = shift;
482 496
483 if ($htype == 0) { # INIT 497 if ($htype == 0) { # INIT
484 my @dirs = ((split /:/, $TERM->resource ("perl_lib")), "$LIBDIR/perl"); 498 my @dirs = ((split /:/, $TERM->resource ("perl_lib")), "$LIBDIR/perl");
485 499
500 my %want_ext;
501
486 my @ext = (map { split /,/, $TERM->resource ("perl_ext_$_") } 1, 2); 502 for (map { split /,/, $TERM->resource ("perl_ext_$_") } 1, 2) {
487
488 while (@ext) {
489 my $ext = shift @ext;
490 if ($ext eq "default") { 503 if ($_ eq "default") {
491 unshift @ext, qw(selection); 504 $want_ext{$_}++ for qw(selection option-popup selection-popup);
505 } elsif (/^-(.*)$/) {
506 delete $want_ext{$1};
492 } else { 507 } else {
493 my @files = grep -f $_, map "$_/$ext", @dirs; 508 $want_ext{$_}++;
494
495 if (@files) {
496 register_package extension_package $files[0];
497 } else {
498 warn "perl extension '$ext' not found in perl library search path\n";
499 }
500 } 509 }
501 } 510 }
511
512 for my $ext (keys %want_ext) {
513 my @files = grep -f $_, map "$_/$ext", @dirs;
514
515 if (@files) {
516 register_package extension_package $files[0];
517 } else {
518 warn "perl extension '$ext' not found in perl library search path\n";
519 }
520 }
521
522 eval "#line 1 \"--perl-eval resource/argument\"\n" . $TERM->resource ("perl_eval");
523 warn $@ if $@;
502 } 524 }
503 525
504 $retval = undef; 526 $retval = undef;
505 527
506 if (my $cb = $TERM->{_hook}[$htype]) { 528 if (my $cb = $TERM->{_hook}[$htype]) {
518 $proxy 540 $proxy
519 }, 541 },
520 @_, 542 @_,
521 ) and last; 543 ) and last;
522 }; 544 };
523 warn $@ if $@;#d# 545 if ($@) {
546 $TERM->ungrab; # better to lose the grab than the session
547 warn $@;
548 }
524 } 549 }
525 } 550 }
526 551
527 if ($htype == 1) { # DESTROY 552 if ($htype == 1) { # DESTROY
528 # remove hooks if unused 553 # remove hooks if unused
541 } 566 }
542 567
543 $retval 568 $retval
544} 569}
545 570
571# urxvt::term::proxy
572
546sub urxvt::term::proxy::AUTOLOAD { 573sub urxvt::term::proxy::AUTOLOAD {
547 $urxvt::term::proxy::AUTOLOAD =~ /:([^:]+)$/ 574 $urxvt::term::proxy::AUTOLOAD =~ /:([^:]+)$/
548 or die "FATAL: \$AUTOLOAD '$urxvt::term::proxy::AUTOLOAD' unparsable"; 575 or die "FATAL: \$AUTOLOAD '$urxvt::term::proxy::AUTOLOAD' unparsable";
549 576
550 eval qq{ 577 eval qq{
556 } or die "FATAL: unable to compile method forwarder: $@"; 583 } or die "FATAL: unable to compile method forwarder: $@";
557 584
558 goto &$urxvt::term::proxy::AUTOLOAD; 585 goto &$urxvt::term::proxy::AUTOLOAD;
559} 586}
560 587
588sub urxvt::term::proxy::DESTROY {
589 # nop
590}
591
592# urxvt::destroy_hook
593
561sub urxvt::destroy_hook::DESTROY { 594sub urxvt::destroy_hook::DESTROY {
562 ${$_[0]}->(); 595 ${$_[0]}->();
563} 596}
564 597
565sub urxvt::destroy_hook(&) { 598sub urxvt::destroy_hook(&) {
566 bless \shift, urxvt::destroy_hook:: 599 bless \shift, urxvt::destroy_hook::
567} 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;
568 671
569=head2 The C<urxvt::term> Class 672=head2 The C<urxvt::term> Class
570 673
571=over 4 674=over 4
572 675
624 shade term_name title transparent transparent_all tripleclickwords 727 shade term_name title transparent transparent_all tripleclickwords
625 utmpInhibit visualBell 728 utmpInhibit visualBell
626 729
627=cut 730=cut
628 731
629sub urxvt::term::resource($$;$) { 732sub resource($$;$) {
630 my ($self, $name) = (shift, shift); 733 my ($self, $name) = (shift, shift);
631 unshift @_, $self, $name, ($name =~ s/\s*\+\s*(\d+)$// ? $1 : 0); 734 unshift @_, $self, $name, ($name =~ s/\s*\+\s*(\d+)$// ? $1 : 0);
632 &urxvt::term::_resource 735 &urxvt::term::_resource
633} 736}
634 737
721C<$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,
722currently). 825currently).
723 826
724=cut 827=cut
725 828
726sub urxvt::term::popup { 829sub popup {
727 my ($self, $event) = @_; 830 my ($self, $event) = @_;
728 831
729 $self->grab ($event->{time}, 1) 832 $self->grab ($event->{time}, 1)
730 or return; 833 or return;
731 834
921 1024
922=back 1025=back
923 1026
924=cut 1027=cut
925 1028
926sub urxvt::term::line { 1029sub line {
927 my ($self, $row) = @_; 1030 my ($self, $row) = @_;
928 1031
929 my $maxrow = $self->nrow - 1; 1032 my $maxrow = $self->nrow - 1;
930 1033
931 my ($beg, $end) = ($row, $row); 1034 my ($beg, $end) = ($row, $row);
1009Converts rxvt-unicodes text reprsentation into a perl string. See 1112Converts rxvt-unicodes text reprsentation into a perl string. See
1010C<< $term->ROW_t >> for details. 1113C<< $term->ROW_t >> for details.
1011 1114
1012=back 1115=back
1013 1116
1117=cut
1118
1119package urxvt::popup;
1120
1014=head2 The C<urxvt::popup> Class 1121=head2 The C<urxvt::popup> Class
1015 1122
1016=over 4 1123=over 4
1017 1124
1018=cut 1125=cut
1019
1020package urxvt::popup;
1021 1126
1022sub add_item { 1127sub add_item {
1023 my ($self, $item) = @_; 1128 my ($self, $item) = @_;
1024 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
1025 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 });
1026} 1160}
1027 1161
1028sub add_button { 1162sub add_button {
1029 my ($self, $text, $cb) = @_; 1163 my ($self, $text, $cb) = @_;
1030 1164
1031 $self->add_item ({ type => "button", text => "[ $text ]", activate => $cb, 1165 $self->add_item ({ type => "button", text => "[ $text ]", activate => $cb});
1032 render => sub { $_[0]{text} },
1033 });
1034} 1166}
1035 1167
1036sub add_toggle { 1168sub add_toggle {
1037 my ($self, $text, $cb, $value) = @_; 1169 my ($self, $text, $cb, $value) = @_;
1038 1170
1039 my $item; $item = { 1171 my $item; $item = {
1040 type => "button", 1172 type => "button",
1041 text => " $text", 1173 text => " $text",
1042 value => $value, 1174 value => $value,
1043 render => sub { ($item->{value} ? "" : " ") . $text }, 1175 render => sub { ($_[0]{value} ? "* " : " ") . $text },
1044 activate => sub { $cb->($item->{value} = !$item->{value}); }, 1176 activate => sub { $cb->($_[0]{value} = !$_[0]{value}); },
1045 }; 1177 };
1046 1178
1047 $self->add_item ($item); 1179 $self->add_item ($item);
1048} 1180}
1049 1181
1059} 1191}
1060 1192
1061sub DESTROY { 1193sub DESTROY {
1062 my ($self) = @_; 1194 my ($self) = @_;
1063 1195
1196 delete $self->{term}{_destroy}{$self};
1064 $self->{term}->ungrab; 1197 $self->{term}->ungrab;
1065} 1198}
1066 1199
1067=head2 The C<urxvt::timer> Class 1200=head2 The C<urxvt::timer> Class
1068 1201
1172This variable controls the verbosity level of the perl extension. Higher 1305This variable controls the verbosity level of the perl extension. Higher
1173numbers indicate more verbose output. 1306numbers indicate more verbose output.
1174 1307
1175=over 4 1308=over 4
1176 1309
1177=item =0 - only fatal messages 1310=item == 0 - fatal messages
1178 1311
1179=item =3 - script loading and management 1312=item >= 3 - script loading and management
1180 1313
1181=item =10 - all events received 1314=item >=10 - all events received
1182 1315
1183=back 1316=back
1184 1317
1185=head1 AUTHOR 1318=head1 AUTHOR
1186 1319

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines