File Coverage

lib/Term/UI/History.pm

Criterion	Covered	Total	%
statement	26	26	100.0
branch	4	4	100.0
condition	2	3	66.6
subroutine	7	7	100.0
pod	1	3	33.3
total	40	43	93.0

package Term::UI::History;
$Term::UI::History::VERSION = '0.50';

use strict;
use warnings;

use parent
  qw! Exporter
      Log::Message::Simple
    !;

use Log::Message 'private' => 0;

our $HISTORY_FH = \ *STDOUT;
our @EXPORT = qw[ history ];

my $log = Log::Message->new();

=pod

=head1 NAME

Term::UI::History - history function

=head1 SYNOPSIS

    use Term::UI::History qw[history];

    history("Some message");

    ### retrieve the history in printable form
    $hist  = Term::UI::History->history_as_string;

    ### redirect output
    local $Term::UI::History::HISTORY_FH = \*STDERR;

=head1 DESCRIPTION

This module provides the C function for C,
printing and saving all the C interaction.

Refer to the C manpage for details on usage from
C.

This module subclasses C. Refer to its
manpage for additional functionality available via this package.

=head1 FUNCTIONS

=head2 history("message string" [,VERBOSE])

Records a message on the stack, and prints it to C
(or actually C<$HISTORY_FH>, see the C section
below), if the C option is true.

The C option defaults to true.

=cut

sub history {
  my $msg = shift;

  $log
    ->store( 'message' => $msg,
             'tag' => 'HISTORY',
             'level' => 'history',
             'extra' => [ @_ ],
           );
}

sub history_as_string {
    my $class = shift;

    return join $/, map { $_->message } __PACKAGE__->stack;
}


{
    package # hide this from PAUSE
      Log::Message::Handlers;

    sub history {
        my $self    = shift;
        my $verbose = shift;
           $verbose = 1 unless defined $verbose;    # default to true

        ### so you don't want us to print the msg? ###
        return if defined $verbose && $verbose == 0;

        local $| = 1;
        my $old_fh = select $Term::UI::History::HISTORY_FH;

        print $self->message . "\n";
        select $old_fh;

        return;
    }
}


=head1 GLOBAL VARIABLES

=over 4

=item $HISTORY_FH

This is the filehandle all the messages sent to C are being
printed. This defaults to C<*STDOUT>.

=back

=head1 See Also

C, C

=head1 AUTHOR

This module by
Jos Boumans [e-mail].

=head1 COPYRIGHT

This module is
copyright (c) 2005 Jos Boumans [e-mail].
All rights reserved.

This library is free software;
you may redistribute and/or modify it under the same
terms as Perl itself.

=cut

1;

# Local variables:
# c-indentation-style: bsd
# c-basic-offset: 4
# indent-tabs-mode: nil
# End:
# vim: expandtab shiftwidth=4: