NAME

Term::ReadLine::Perl5 - A Perl5 implementation GNU Readline

Overview

This is a implementation of the GNU Readline/History Library written in Perl5.

GNU Readline reads lines from an interactive terminal with emacs or vi editing capabilities. It provides as mechanism for saving history of previous input.

This package typically used in command-line interfaces and REPLs (Read, Eval, Print, Loop).

SYNOPSIS

  use Term::ReadLine::Perl5;
  $term = new Term::ReadLine::Perl5 'ProgramName';
  while ( defined ($_ = $term->readline('prompt>')) ) {
    ...
  }

Variables

Following GNU Readline/History Library variables can be accessed from Perl program. See 'GNU Readline Library Manual' and ' GNU History Library Manual' for each variable. You can access them via the Attribs method. Names of keys in this hash conform to standard conventions with the leading rl_ stripped.

Example:

    $term = new Term::ReadLine::Perl5 'ReadLineTest'
    $attribs = $term->Attribs;
    $v = $attribs->{history_base};      # history_base

Attribute Names

        completion_suppress_append (bool)
        history_base               (int)
        history_stifled            (int)
        history_length             (int)
        max_input_history          (int)
        outstream                  (file handle)

SUBROUTINES

new

Term::ReadLine::Perl->new($name, [*IN, [*OUT])

Returns a handle for subsequent calls to readline functions.

$name is the name of the application.

Optionally you can add two arguments for input and output filehandles. These arguments should be globs.

This routine might also be called via Term::ReadLine->new($term_name) if other Term::ReadLine packages like Term::ReadLine::Gnu is not available or if you have $ENV{PERL_RL} set to 'Perl5';

Note: Some additional feature via Term::ReadLine::Stub are added when a "new" is done

At present, because this code has lots of global state, we currently don't support more than one readline instance.

Somebody please volunteer to rewrite this code!

Minline

MinLine([$minlength])

If $minlength is given, set $readline::minlength the minimum length a $line for it to go into the readline history.

The previous value is returned.

History Subroutines

stifle_history

stifle_history($max)

Stifle or put a cap on the history list, remembering only $max number of lines.

remove_history

remove_history($which)

Remove history element $which from the history. The removed element is returned.

cpanm Term::ReadLine::Perl5

perl -MCPAN -e shell
install Term::ReadLine::Perl5