The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

Term::YAP - show pulsed progress bar in terminal

SYNOPSIS

    use Term::YAP;
        
        my $yap = Term::YAP->new( { name => 'Checking', rotate => 0, time => 1 } );
        
    $yap->start(); # start the pulse
    # do something between
    $yap->stop() # stop it

DESCRIPTION

Term::YAP is a Moo based class to implement a "pulse" bar in a terminal. A pulse bar does not shows any progress of the task being executed but at least shows that the program is working instead of showing nothing for user.

This is the parent class and some methods were not implemented, you probably want to look for subclasses to get an implementation.

This module was shamelessly copied from Term::Pulse. Sorry, couldn't get my bug/patch approved. :-)

EXPORT

Nothing.

ATTRIBUTES

All attributes are optional and have their respective default values.

name

A simple message displayed before the pulse. The default value is 'Working'.

rotatable

Boolean. Rotates the pulse if set to true. It is false by default.

time

Boolean. Display the elapsed time if set to 1. Turn off by default.

size

Set the pulse size. The default value is 16.

METHODS

BUILD

Install handlers for signals.

get_name

Returns the value of the name attribute.

is_rotatable

Returns the value of rotatable attribute.

show_time

Returns the value of time attribute.

get_size

Returns the value of size attribute.

start

Starts the pulse.

stop

Stop the pulse and return elapsed time.

SEE ALSO

AUTHOR

Alceu Rodrigues de Freitas Junior, <arfreitas@cpan.org>

Term::Pulse was originally created by Yen-Liang Chen, <alec at cpan.com>

COPYRIGHT AND LICENSE

This software is copyright (c) 2015 of Alceu Rodrigues de Freitas Junior, <arfreitas@cpan.org>

This file is part of Term-YAP distribution.

Term-YAP is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

Term-YAP is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with Term-YAP. If not, see <http://www.gnu.org/licenses/>.