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.54 by root, Sun Jan 8 01:59:29 2006 UTC vs.
Revision 1.62 by root, Mon Jan 9 02:06:43 2006 UTC

58 58
59=back 59=back
60 60
61=item option-popup (enabled by default) 61=item option-popup (enabled by default)
62 62
63Binds a popup menu to Ctrl-Button3 that lets you toggle (some) options at 63Binds a popup menu to Ctrl-Button2 that lets you toggle (some) options at
64runtime. 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.
65 70
66=item digital-clock 71=item digital-clock
67 72
68Displays a digital clock using the built-in overlay. 73Displays a digital clock using the built-in overlay.
69 74
200 205
201It is called before lines are scrolled out (so rows 0 .. min ($lines - 1, 206It is called before lines are scrolled out (so rows 0 .. min ($lines - 1,
202$nrow - 1) represent the lines to be scrolled out). C<$saved> is the total 207$nrow - 1) represent the lines to be scrolled out). C<$saved> is the total
203number of lines that will be in the scrollback buffer. 208number of lines that will be in the scrollback buffer.
204 209
205=item on_tty_activity $term *NYI*
206
207Called whenever the program(s) running in the urxvt window send output.
208
209=item on_osc_seq $term, $string 210=item on_osc_seq $term, $string
210 211
211Called whenever the B<ESC ] 777 ; string ST> command sequence (OSC = 212Called whenever the B<ESC ] 777 ; string ST> command sequence (OSC =
212operating system command) is processed. Cursor position and other state 213operating system command) is processed. Cursor position and other state
213information is up-to-date when this happens. For interoperability, the 214information is up-to-date when this happens. For interoperability, the
332that calls this function. 333that calls this function.
333 334
334Using this function has the advantage that its output ends up in the 335Using this function has the advantage that its output ends up in the
335correct place, e.g. on stderr of the connecting urxvtc client. 336correct place, e.g. on stderr of the connecting urxvtc client.
336 337
338=item $is_safe = urxvt::safe
339
340Returns true when it is safe to do potentially unsafe things, such as
341evaluating perl code specified by the user. This is true when urxvt was
342started setuid or setgid.
343
337=item $time = urxvt::NOW 344=item $time = urxvt::NOW
338 345
339Returns the "current time" (as per the event loop). 346Returns the "current time" (as per the event loop).
340 347
341=item urxvt::CurrentTime 348=item urxvt::CurrentTime
342 349
343=item urxvt::ShiftMask, LockMask, ControlMask, Mod1Mask, Mod2Mask, 350=item urxvt::ShiftMask, LockMask, ControlMask, Mod1Mask, Mod2Mask,
344Mod3Mask, Mod4Mask, Mod5Mask, Button1Mask, Button2Mask, Button3Mask, 351Mod3Mask, Mod4Mask, Mod5Mask, Button1Mask, Button2Mask, Button3Mask,
345Button4Mask, Button5Mask, AnyModifier 352Button4Mask, Button5Mask, AnyModifier
346 353
347Various constants for use in X events. 354Various constants for use in X calls and event processing.
348 355
349=back 356=back
350 357
351=head2 RENDITION 358=head2 RENDITION
352 359
407use utf8; 414use utf8;
408use strict; 415use strict;
409use Scalar::Util (); 416use Scalar::Util ();
410use List::Util (); 417use List::Util ();
411 418
419our $VERSION = 1;
412our $TERM; 420our $TERM;
413our @HOOKNAME; 421our @HOOKNAME;
414our %OPTION; 422our %OPTION;
415our $LIBDIR; 423our $LIBDIR;
416 424
422 my $msg = join "", @_; 430 my $msg = join "", @_;
423 $msg .= "\n" 431 $msg .= "\n"
424 unless $msg =~ /\n$/; 432 unless $msg =~ /\n$/;
425 urxvt::warn ($msg); 433 urxvt::warn ($msg);
426 }; 434 };
435
436 delete $ENV{IFS};
437 delete $ENV{CDPATH};
438 delete $ENV{BASH_ENV};
439 $ENV{PATH} = "/bin:/sbin:/usr/bin:/usr/sbin:/usr/local/bin:/usr/local/sbin:/opt/bin:/opt/sbin";
427} 440}
428 441
429my @hook_count; 442my @hook_count;
430my $verbosity = $ENV{URXVT_PERL_VERBOSITY}; 443my $verbosity = $ENV{URXVT_PERL_VERBOSITY};
431 444
464 verbose 3, "loading extension '$path' into package '$pkg'"; 477 verbose 3, "loading extension '$path' into package '$pkg'";
465 478
466 open my $fh, "<:raw", $path 479 open my $fh, "<:raw", $path
467 or die "$path: $!"; 480 or die "$path: $!";
468 481
469 my $source = "package $pkg; use strict; use utf8;\n" 482 my $source = untaint "package $pkg; use strict; use utf8;\n"
470 . "use base urxvt::term::proxy::;\n" 483 . "use base urxvt::term::proxy::;\n"
471 . "#line 1 \"$path\"\n{\n" 484 . "#line 1 \"$path\"\n{\n"
472 . (do { local $/; <$fh> }) 485 . (do { local $/; <$fh> })
473 . "\n};\n1"; 486 . "\n};\n1";
474 487
490 503
491 my %want_ext; 504 my %want_ext;
492 505
493 for (map { split /,/, $TERM->resource ("perl_ext_$_") } 1, 2) { 506 for (map { split /,/, $TERM->resource ("perl_ext_$_") } 1, 2) {
494 if ($_ eq "default") { 507 if ($_ eq "default") {
495 $want_ext{$_}++ for qw(selection option-popup); 508 $want_ext{$_}++ for qw(selection option-popup selection-popup);
496 } elsif (/^-(.*)$/) { 509 } elsif (/^-(.*)$/) {
497 delete $want_ext{$1}; 510 delete $want_ext{$1};
498 } else { 511 } else {
499 $want_ext{$_}++; 512 $want_ext{$_}++;
500 } 513 }
507 register_package extension_package $files[0]; 520 register_package extension_package $files[0];
508 } else { 521 } else {
509 warn "perl extension '$ext' not found in perl library search path\n"; 522 warn "perl extension '$ext' not found in perl library search path\n";
510 } 523 }
511 } 524 }
525
526 eval "#line 1 \"--perl-eval resource/argument\"\n" . $TERM->resource ("perl_eval");
527 warn $@ if $@;
512 } 528 }
513 529
514 $retval = undef; 530 $retval = undef;
515 531
516 if (my $cb = $TERM->{_hook}[$htype]) { 532 if (my $cb = $TERM->{_hook}[$htype]) {
528 $proxy 544 $proxy
529 }, 545 },
530 @_, 546 @_,
531 ) and last; 547 ) and last;
532 }; 548 };
533 warn $@ if $@;#d# 549 if ($@) {
550 $TERM->ungrab; # better to lose the grab than the session
551 warn $@;
552 }
534 } 553 }
535 } 554 }
536 555
537 if ($htype == 1) { # DESTROY 556 if ($htype == 1) { # DESTROY
538 # remove hooks if unused 557 # remove hooks if unused
551 } 570 }
552 571
553 $retval 572 $retval
554} 573}
555 574
575# urxvt::term::proxy
576
556sub urxvt::term::proxy::AUTOLOAD { 577sub urxvt::term::proxy::AUTOLOAD {
557 $urxvt::term::proxy::AUTOLOAD =~ /:([^:]+)$/ 578 $urxvt::term::proxy::AUTOLOAD =~ /:([^:]+)$/
558 or die "FATAL: \$AUTOLOAD '$urxvt::term::proxy::AUTOLOAD' unparsable"; 579 or die "FATAL: \$AUTOLOAD '$urxvt::term::proxy::AUTOLOAD' unparsable";
559 580
560 eval qq{ 581 eval qq{
566 } or die "FATAL: unable to compile method forwarder: $@"; 587 } or die "FATAL: unable to compile method forwarder: $@";
567 588
568 goto &$urxvt::term::proxy::AUTOLOAD; 589 goto &$urxvt::term::proxy::AUTOLOAD;
569} 590}
570 591
592sub urxvt::term::proxy::DESTROY {
593 # nop
594}
595
596# urxvt::destroy_hook
597
571sub urxvt::destroy_hook::DESTROY { 598sub urxvt::destroy_hook::DESTROY {
572 ${$_[0]}->(); 599 ${$_[0]}->();
573} 600}
574 601
575sub urxvt::destroy_hook(&) { 602sub urxvt::destroy_hook(&) {
576 bless \shift, urxvt::destroy_hook:: 603 bless \shift, urxvt::destroy_hook::
577} 604}
605
606package urxvt::anyevent;
607
608=head2 The C<urxvt::anyevent> Class
609
610The sole purpose of this class is to deliver an interface to the
611C<AnyEvent> module - any module using it will work inside urxvt without
612further work. The only exception is that you cannot wait on condition
613variables, but non-blocking condvar use is ok. What this means is that you
614cannot use blocking APIs, but the non-blocking variant should work.
615
616=cut
617
618our $VERSION = 1;
619
620$INC{"urxvt/anyevent.pm"} = 1; # mark us as there
621push @AnyEvent::REGISTRY, [urxvt => urxvt::anyevent::];
622
623sub timer {
624 my ($class, %arg) = @_;
625
626 my $cb = $arg{cb};
627
628 urxvt::timer
629 ->new
630 ->start (urxvt::NOW + $arg{after})
631 ->cb (sub {
632 $_[0]->stop; # need to cancel manually
633 $cb->();
634 })
635}
636
637sub io {
638 my ($class, %arg) = @_;
639
640 my $cb = $arg{cb};
641
642 bless [$arg{fh}, urxvt::iow
643 ->new
644 ->fd (fileno $arg{fh})
645 ->events (($arg{poll} =~ /r/ ? 1 : 0)
646 | ($arg{poll} =~ /w/ ? 2 : 0))
647 ->start
648 ->cb (sub {
649 $cb->(($_[1] & 1 ? 'r' : '')
650 . ($_[1] & 2 ? 'w' : ''));
651 })],
652 urxvt::anyevent::
653}
654
655sub DESTROY {
656 $_[0][1]->stop;
657}
658
659sub condvar {
660 bless \my $flag, urxvt::anyevent::condvar::
661}
662
663sub urxvt::anyevent::condvar::broadcast {
664 ${$_[0]}++;
665}
666
667sub urxvt::anyevent::condvar::wait {
668 unless (${$_[0]}) {
669 require Carp;
670 Carp::croak ("AnyEvent->condvar blocking wait unsupported in urxvt, use a non-blocking API");
671 }
672}
673
674package urxvt::term;
578 675
579=head2 The C<urxvt::term> Class 676=head2 The C<urxvt::term> Class
580 677
581=over 4 678=over 4
582 679
634 shade term_name title transparent transparent_all tripleclickwords 731 shade term_name title transparent transparent_all tripleclickwords
635 utmpInhibit visualBell 732 utmpInhibit visualBell
636 733
637=cut 734=cut
638 735
639sub urxvt::term::resource($$;$) { 736sub resource($$;$) {
640 my ($self, $name) = (shift, shift); 737 my ($self, $name) = (shift, shift);
641 unshift @_, $self, $name, ($name =~ s/\s*\+\s*(\d+)$// ? $1 : 0); 738 unshift @_, $self, $name, ($name =~ s/\s*\+\s*(\d+)$// ? $1 : 0);
642 &urxvt::term::_resource 739 &urxvt::term::_resource
643} 740}
644 741
731C<$event> I<must> be the event causing the menu to pop up (a button event, 828C<$event> I<must> be the event causing the menu to pop up (a button event,
732currently). 829currently).
733 830
734=cut 831=cut
735 832
736sub urxvt::term::popup { 833sub popup {
737 my ($self, $event) = @_; 834 my ($self, $event) = @_;
738 835
739 $self->grab ($event->{time}, 1) 836 $self->grab ($event->{time}, 1)
740 or return; 837 or return;
741 838
931 1028
932=back 1029=back
933 1030
934=cut 1031=cut
935 1032
936sub urxvt::term::line { 1033sub line {
937 my ($self, $row) = @_; 1034 my ($self, $row) = @_;
938 1035
939 my $maxrow = $self->nrow - 1; 1036 my $maxrow = $self->nrow - 1;
940 1037
941 my ($beg, $end) = ($row, $row); 1038 my ($beg, $end) = ($row, $row);
1005 $offset / $self->{ncol} + $self->{beg}, 1102 $offset / $self->{ncol} + $self->{beg},
1006 $offset % $self->{ncol} 1103 $offset % $self->{ncol}
1007 ) 1104 )
1008} 1105}
1009 1106
1010=item ($row, $col) = $line->coord_of ($offset)
1011=item $text = $term->special_encode $string 1107=item $text = $term->special_encode $string
1012 1108
1013Converts a perl string into the special encoding used by rxvt-unicode, 1109Converts a perl string into the special encoding used by rxvt-unicode,
1014where one character corresponds to one screen cell. See 1110where one character corresponds to one screen cell. See
1015C<< $term->ROW_t >> for details. 1111C<< $term->ROW_t >> for details.
1017=item $string = $term->special_decode $text 1113=item $string = $term->special_decode $text
1018 1114
1019Converts rxvt-unicodes text reprsentation into a perl string. See 1115Converts rxvt-unicodes text reprsentation into a perl string. See
1020C<< $term->ROW_t >> for details. 1116C<< $term->ROW_t >> for details.
1021 1117
1118=item $success = $term->grab_button ($button, $modifiermask)
1119
1120Registers a synchronous button grab. See XGrabButton.
1121
1122=item $success = $term->grab ($eventtime[, $sync])
1123
1124Calls XGrabPointer and XGrabKeyboard in asynchronous (default) or
1125synchronous (C<$sync> is true). Also remembers the grab timestampe.
1126
1127=item $term->allow_events_async
1128
1129Calls XAllowEvents with AsyncBoth for the most recent grab.
1130
1131=item $term->allow_events_sync
1132
1133Calls XAllowEvents with SyncBoth for the most recent grab.
1134
1135=item $term->allow_events_replay
1136
1137Calls XAllowEvents with both ReplayPointer and ReplayKeyboard for the most
1138recent grab.
1139
1140=item $term->ungrab
1141
1142Calls XUngrab for the most recent grab. Is called automatically on
1143evaluation errors, as it is better to lose the grab in the error case as
1144the session.
1145
1022=back 1146=back
1023 1147
1148=cut
1149
1150package urxvt::popup;
1151
1024=head2 The C<urxvt::popup> Class 1152=head2 The C<urxvt::popup> Class
1025 1153
1026=over 4 1154=over 4
1027 1155
1028=cut 1156=cut
1029
1030package urxvt::popup;
1031 1157
1032sub add_item { 1158sub add_item {
1033 my ($self, $item) = @_; 1159 my ($self, $item) = @_;
1034 1160
1035 $item->{rend}{normal} = "\x1b[0;30;47m" unless exists $item->{rend}{normal}; 1161 $item->{rend}{normal} = "\x1b[0;30;47m" unless exists $item->{rend}{normal};
1075 1201
1076 my $item; $item = { 1202 my $item; $item = {
1077 type => "button", 1203 type => "button",
1078 text => " $text", 1204 text => " $text",
1079 value => $value, 1205 value => $value,
1080 render => sub { ($item->{value} ? "* " : " ") . $text }, 1206 render => sub { ($_[0]{value} ? "* " : " ") . $text },
1081 activate => sub { $cb->($item->{value} = !$item->{value}); }, 1207 activate => sub { $cb->($_[0]{value} = !$_[0]{value}); },
1082 }; 1208 };
1083 1209
1084 $self->add_item ($item); 1210 $self->add_item ($item);
1085} 1211}
1086 1212
1096} 1222}
1097 1223
1098sub DESTROY { 1224sub DESTROY {
1099 my ($self) = @_; 1225 my ($self) = @_;
1100 1226
1227 delete $self->{term}{_destroy}{$self};
1101 $self->{term}->ungrab; 1228 $self->{term}->ungrab;
1102} 1229}
1103 1230
1104=head2 The C<urxvt::timer> Class 1231=head2 The C<urxvt::timer> Class
1105 1232
1209This variable controls the verbosity level of the perl extension. Higher 1336This variable controls the verbosity level of the perl extension. Higher
1210numbers indicate more verbose output. 1337numbers indicate more verbose output.
1211 1338
1212=over 4 1339=over 4
1213 1340
1214=item =0 - only fatal messages 1341=item == 0 - fatal messages
1215 1342
1216=item =3 - script loading and management 1343=item >= 3 - script loading and management
1217 1344
1218=item =10 - all events received 1345=item >=10 - all events received
1219 1346
1220=back 1347=back
1221 1348
1222=head1 AUTHOR 1349=head1 AUTHOR
1223 1350

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines