view release on metacpan or  search on metacpan

lib/Acme/Dahut/Call.pm  view on Meta::CPAN

                'DAHUUT!!',         'A THUD!',
                'AD HUT!',          'HAT DU!',
                'AT HUD!',          '-.. .- .... ..- -',
                'DAHUUUUT!',        'DAAAHUUT',
                'DAHUT?'
            )
        ];
    },
);

has actions => (
    isa        => 'ArrayRef',
    is         => 'ro',
    auto_deref => 1,
    default    => sub {
        [
            (
                'hides from the chaotic noise',
                'topples down the mountain',
                'scurries around in circles',
            )
        ];
    },
);

sub call {
    my $self  = shift;
    my @calls = $self->calls;
    return @calls[ rand scalar @calls ];
}

sub action {
    my $self    = shift;
    my @actions = $self->actions;
    return @actions[ rand scalar @actions ];
}

1;
__END__

=head1 NAME

Acme::Dahut::Call - replicates the melodious sound of the wild Dahut ... in Text.


=head1 VERSION

This document describes Acme::Dahut::Call version 0.0.1


=head1 SYNOPSIS

    use Acme::Dahut::Call;
    my $fauxhut = Acme::Dahut::Call->new();
    print $fauxhut->call()
  
=head1 DESCRIPTION

    The vocal ability of dahuts has inspired poets and musicians, from Chaucer to Wordsworth, 
    from Handel to Respighi. Dahutsong can be a natural phenomenon of intense beauty. But our 
    enjoyment is incidental to the main purpose, which is one dahut communicating with others. 
    Dahuts became the world's master musicians in order to convey to potential mates, rivals 
    and predators all the important things they have to say, from "Clear off!" to "Come on!" 
    to "Where's the Beer?"[1]

=head1 METHODS 

=over

=item new()

Create a new Acme::Dahut::Call object. Because the melodious sound of the Dahut cannot be 
captured all at one time you can pass in a new list of lines with the C<calls> or the C<actions> param.

=item action()

Simulates the more "active" response of a Dahut to it's native cry.

=item actions()

Returns an ArrayRef of all "active" responses. 

=item call() 

Returns a random call from the wild Dahut.

=item calls()

Returns an ArrayRef of all possible Dahut Calls.

=item meta()

Returns the Class metaobjbect. See L<Class::MOP::Class> for details.

=back

=head1 CONFIGURATION AND ENVIRONMENT

=for author to fill in:
    A full explanation of any configuration system(s) used by the
    module, including the names and locations of any configuration
    files, and the meaning of any environment variables or properties
    that can be set. These descriptions must also include details of any
    configuration language used.
  
Acme::Dahut::Call requires no configuration files or environment variables.


=head1 DEPENDENCIES

=for author to fill in:
    A list of all the other modules that this module relies upon,
    including any restrictions on versions, and an indication whether
    the module is part of the standard Perl distribution, part of the
    module's distribution, or must be installed separately. ]

None.


=head1 INCOMPATIBILITIES