NAME

Acme::AsciiArtFarts - Simple Object Interface to AsciiArtFarts

VERSION

Version 0.01

SYNOPSIS

This package provides a simple object orientated interface to AsciiArtFarts - a website focussed on Ascii Art humour.

        use Acme::AsciiArtFarts;

        my $aaf = Acme::AsciiArtFarts->new();

        my $current = $aaf->current();
        print $current;

METHODS

new

Constructor - creates a new Acme:AsciiArtFarts object. This method takes no arguments.

current

        print $aaf->current();

Returns the current strip.

random

        print $aaf->random();

Returns a random strip.

list_keywords

        print join " ", $aaf->list_keywords();

Returns a list of all keywords by which strips are sorted.

list_by_keyword

        my @art = $aaf->list_by_keyword('matrix');

Returns a list of strip numbers for the given keyword.

get_by_num

        print $aaf->get_by_num($art[0]);

        print $aaf->get_by_num(int rand 1000);

Given a strip number as returned by other methods, return the requested strip.

Alternately, given an integer value that is a valid strip number, return the requested strip.

AUTHOR

Luke Poskitt, <ltp at cpan.org>

BUGS

Please report any bugs or feature requests to bug-acme-asciiartfarts at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Acme-AsciiArtFarts. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

SUPPORT

You can find documentation for this module with the perldoc command.

    perldoc Acme::AsciiArtFarts

You can also look for information at:

• RT: CPAN's request tracker

  http://rt.cpan.org/NoAuth/Bugs.html?Dist=Acme-AsciiArtFarts

• AnnoCPAN: Annotated CPAN documentation

  http://annocpan.org/dist/Acme-AsciiArtFarts

• CPAN Ratings

  http://cpanratings.perl.org/d/Acme-AsciiArtFarts

• Search CPAN

  http://search.cpan.org/dist/Acme-AsciiArtFarts/

ACKNOWLEDGEMENTS

LICENSE AND COPYRIGHT

Copyright 2011 Luke Poskitt.

This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License.

See http://dev.perl.org/licenses/ for more information.

cpanm Acme::AsciiArtFarts

perl -MCPAN -e shell
install Acme::AsciiArtFarts