Admin

name	type	size	perms	modified	actions
[parent directory]
BlackBox.pm	file	86,643 B	0644	2023-05-11 19:13:11	edit
Checker.pm	file	5,416 B	0644	2023-05-11 19:13:11	edit
Debug.pm	file	4,596 B	0644	2023-05-11 19:13:11	edit
DumpAsText.pm	file	4,039 B	0644	2023-05-11 19:13:11	edit
DumpAsXML.pm	file	4,569 B	0644	2023-05-11 19:13:11	edit
HTML.pm	file	34,621 B	0644	2023-05-11 19:13:11	edit
HTMLBatch.pm	file	40,514 B	0644	2023-05-11 19:13:11	edit
HTMLLegacy.pm	file	2,731 B	0644	2023-05-11 19:09:14	edit
JustPod.pm	file	9,632 B	0644	2023-05-11 19:09:14	edit
LinkSection.pm	file	4,282 B	0644	2023-05-11 19:13:11	edit
Methody.pm	file	3,555 B	0644	2023-05-11 19:13:11	edit
Progress.pm	file	2,419 B	0644	2023-05-11 19:13:11	edit
PullParser.pm	file	25,663 B	0644	2023-05-11 19:13:11	edit
PullParserEndToken.pm	file	2,868 B	0644	2023-05-11 19:13:11	edit
PullParserStartToken.pm	file	4,130 B	0644	2023-05-11 19:13:11	edit
PullParserTextToken.pm	file	3,347 B	0644	2023-05-11 19:13:11	edit
PullParserToken.pm	file	4,016 B	0644	2023-05-11 19:13:11	edit
RTF.pm	file	23,460 B	0644	2023-05-11 19:13:11	edit
Search.pm	file	35,731 B	0644	2023-05-11 19:13:11	edit
SimpleTree.pm	file	4,592 B	0644	2023-05-11 19:13:11	edit
Subclassing.pod	file	34,079 B	0644	2023-05-11 19:09:14	edit
Text.pm	file	5,093 B	0644	2023-05-11 19:13:11	edit
TextContent.pm	file	2,499 B	0644	2023-05-11 19:13:11	edit
TiedOutFH.pm	file	2,735 B	0644	2023-05-11 19:13:11	edit
Transcode.pm	file	710 B	0644	2023-05-11 19:13:11	edit
TranscodeDumb.pm	file	2,605 B	0644	2023-05-11 19:13:11	edit
TranscodeSmart.pm	file	693 B	0644	2023-05-11 19:13:11	edit
XHTML.pm	file	27,806 B	0644	2023-05-11 19:13:11	edit
XMLOutStream.pm	file	4,659 B	0644	2023-05-11 19:13:11	edit

editing: Progress.pm

package Pod::Simple::Progress;
use strict;
use warnings;

our $VERSION = '3.45';

# Objects of this class are used for noting progress of an
#  operation every so often.  Messages delivered more often than that
#  are suppressed.
#
# There's actually nothing in here that's specific to Pod processing;
#  but it's ad-hoc enough that I'm not willing to give it a name that
#  implies that it's generally useful, like "IO::Progress" or something.
#
# -- sburke
#
#--------------------------------------------------------------------------

sub new {
  my($class,$delay) = @_;
  my $self = bless {'quiet_until' => 1},  ref($class) || $class;
  $self->to(*STDOUT{IO});
  $self->delay(defined($delay) ? $delay : 5);
  return $self;
}

sub copy {
  my $orig = shift;
  bless {%$orig, 'quiet_until' => 1}, ref($orig);
}
#--------------------------------------------------------------------------

sub reach {
  my($self, $point, $note) = @_;
  if( (my $now = time) >= $self->{'quiet_until'}) {
    my $goal;
    my    $to = $self->{'to'};
    print $to join('',
      ($self->{'quiet_until'} == 1) ? () : '... ',
      (defined $point) ? (
        '#',
        ($goal = $self->{'goal'}) ? (
          ' ' x (length($goal) - length($point)),
          $point, '/', $goal,
        ) : $point,
        $note ? ': ' : (),
      ) : (),
      $note || '',
      "\n"
    );
    $self->{'quiet_until'} = $now + $self->{'delay'};
  }
  return $self;
}

#--------------------------------------------------------------------------

sub done {
  my($self, $note) = @_;
  $self->{'quiet_until'} = 1;
  return $self->reach( undef, $note );
}

#--------------------------------------------------------------------------
# Simple accessors:

sub delay {
  return $_[0]{'delay'} if @_ == 1; $_[0]{'delay'} = $_[1]; return $_[0] }
sub goal {
  return $_[0]{'goal' } if @_ == 1; $_[0]{'goal' } = $_[1]; return $_[0] }
sub to   {
  return $_[0]{'to'   } if @_ == 1; $_[0]{'to'   } = $_[1]; return $_[0] }

#--------------------------------------------------------------------------

unless(caller) { # Simple self-test:
  my $p = __PACKAGE__->new->goal(5);
  $p->reach(1, "Primus!");
  sleep 1;
  $p->reach(2, "Secundus!");
  sleep 3;
  $p->reach(3, "Tertius!");
  sleep 5;
  $p->reach(4);
  $p->reach(5, "Quintus!");
  sleep 1;
  $p->done("All done");
}

#--------------------------------------------------------------------------
1;
__END__

cancel