view release on metacpan or  search on metacpan

bin/ppll  view on Meta::CPAN

=over

=item C<N..M>

Parameters are from I<N> to I<M>, inclusive.

=item C<M>

Parameters are from 1 to I<M>, inclusive.

=back

=item B<--serial-lines-parallel-fields>

=item B<-slpf>

Alias for C<--mode slpf>.

=back

=head2 OUTPUT

=over

=item B<--colour>

=item B<--color>

=item B<--no-colour>

=item B<--no-color>

Turn on or off ANSI colours in the output.

The default is to enable colours if STDOUT is a TTY.

=item B<--markers>

=item B<--no-markers>

Prefix (the default), or don’t prefix, jobs’ STDOUT and STDERR output with
C<E<gt>> or C<≫>, respectively.

=item B<--quiet>

=item B<-q>

Print less. Can be repeated for less and less.

=item B<--summary>

=item B<-S>

=item B<--no-summary>

Print (the default if there’s more than one parameter), or don’t print, a
summary of how many jobs ran and which of them failed.

=item B<--timestamp-format> I<FORMAT>

Format timestamps using I<FORMAT>. See L<DateTime::strftime|DateTime::strftime>.

The default is C<%T.%3N>.

Implies B<--timestamps>.

=item B<--timestamps>

=item B<-t>

Prefix lines from jobs’ output with a timestamp. The time printed will be the
I<approximate> time the line was printed by the job.

=item B<--verbose>

=item B<-v>

Print more. Can be repeated for more and more.

=back

=head1 DIAGNOSTICS

=head1 CONFIGURATION AND ENVIRONMENT

C<ppll> uses some environment variables in some cases:

=over

=item C<COLUMNS>

If set then used when printing things across the whole width of the terminal. If
not set then C<ppll> will try to work out the terminal width in other ways,
falling back to 80.

=item C<IFS>

Used for splitting lines into fields, e.g. with C<--fields> or
C<--serial-lines-parallel-fields>.

=item C<SHELL>

Used with C<--commmand> (C<-c>).

=back

=head1 EXAMPLES

    ppll -t make

Run a long-running command, e.g. C<make>, and prefix the output with timestamps.

    ppll -j 10 -s 1..1000 gobbledygook --with-rigmarole --number

For each number from 1 to 1,000 (inclusive), run the C<gobbledygook> command
with some arguments. Add the a number as the last argument, e.g. C<gobbledygook
--with-rigmarole --number 42>.

Run no more than 10 such commands at a time.

    ppll curl -o photo-of-a-{}.jpg http://example.com/img/{}.jpg <<EOF