Acme-Cow
view release on metacpan or search on metacpan
package Acme::Cow;
use strict;
$Acme::Cow::VERSION = '0.2.1';
# Preloaded methods go here.
# Autoload methods go after =cut, and are processed by the autosplit program.
# Below is stub documentation for your module. You better edit it!
=head1 NAME
Acme::Cow - Talking barnyard animals (or ASCII art in general)
=head1 SYNOPSIS
use Acme::Cow;
(optional) A scalar that can be interpreted as a C<STRING> type
for C<Text::Template>.
=item Returns
An ASCII rendering of your cow.
=item Notes
If you're using an external file for a cow template, any difficulties
in processing the file will occur in this method.
Every time this method is called, the result is recalculated; there
is no caching of results.
=back
=cut
sub as_string
{
generates an ASCII picture of a cow saying something provided by
the user. If run with no arguments, it accepts standard input,
word-wraps the message given at about 40 columns, and prints the
cow saying the given message on standard output.
To aid in the use of arbitrary messages with arbitrary whitespace,
B<-n> option. If it is specified, the given message will not be
word-wrapped. This is possibly useful if you want to make the cow
think or speak in B<figlet(6)>. If B<-n> is specified, there must
not be any command-line arguments left after all the switches have
been processed.
The B<-W> specifies roughly (where the message should be wrapped.
The default is equivalent to invoking with B<-W 40>, i.e. wrap
words at or before the 40th column.
If any command-line arguments are left over after all switches have
been processed, they become the cow's message. The program will
not accept standard input for a message in this case.
There are several provided modes which change the appearance of
the cow depending on its particular emotional/physical state. The
B<-b> option initiates Borg mode; B<-d> causes the cow to appear
dead; B<-g> invokes greedy mode; B<-p> causes a state of paranoia
to come over the cow; B<-s> makes the cow appear thoroughly stoned;
B<-t> yields a tired cow; B<-w> is somewhat the opposite of B<-t>,
and initiates wired mode; B<-y> brings on the cow's youthful
appearance.
generates an ASCII picture of a cow saying something provided by
the user. If run with no arguments, it accepts standard input,
word-wraps the message given at about 40 columns, and prints the
cow saying the given message on standard output.
To aid in the use of arbitrary messages with arbitrary whitespace,
B<-n> option. If it is specified, the given message will not be
word-wrapped. This is possibly useful if you want to make the cow
think or speak in B<figlet(6)>. If B<-n> is specified, there must
not be any command-line arguments left after all the switches have
been processed.
The B<-W> specifies roughly (where the message should be wrapped.
The default is equivalent to invoking with B<-W 40>, i.e. wrap
words at or before the 40th column.
If any command-line arguments are left over after all switches have
been processed, they become the cow's message. The program will
not accept standard input for a message in this case.
There are several provided modes which change the appearance of
the cow depending on its particular emotional/physical state. The
B<-b> option initiates Borg mode; B<-d> causes the cow to appear
dead; B<-g> invokes greedy mode; B<-p> causes a state of paranoia
to come over the cow; B<-s> makes the cow appear thoroughly stoned;
B<-t> yields a tired cow; B<-w> is somewhat the opposite of B<-t>,
and initiates wired mode; B<-y> brings on the cow's youthful
appearance.
( run in 0.375 second using v1.01-cache-2.11-cpan-8d75d55dd25 )