NAME
    WWW::FMyLife - Obtain FMyLife.com anectodes via API

VERSION
    Version 0.02

SYNOPSIS
    THIS MODULE IS STILL UNDER INITIAL DEVELOPMENT! BE WARNED!

    This module fetches FMyLife.com (FML) anecdotes, comments, votes and
    more via API, comfortably.

        use WWW::FMyLife;

        my $fml    = WWW::FMyLife->new();
        print map { "Items: $_\n" } $fml->last();

        my @items = $fml->last();
        foreach my $item (@items) {
            my $item_id      = $item->id;
            my $item_content = $item->content;
            print "[$item_id] $item_content\n";
        }

        my @text_items = $fml->last( { as => 'text' } );
        print "Items:\n", join "\n", @text_items;
        ...

EXPORT
    This module exports nothing.

METHODS
  Working
    Right now the only thing working and tested properly is the last()
    method

  last()
    Fetches the last quotes. Can accept a hashref that indicates the
    formatting:

        # returns an array of WWW::FMyLife::Item objects
        $fml->last();

        # or, more explicitly
        $fml->last( { as => 'object' } ); # same
        $fml->last( { as => 'text'   } ); # returns the anecdotes as array
        $fml->last( { as => 'data'   } ); # returns hashes with the data as array

    You can only specify which page you want:

        # return 1st page
        my @last = fml->last();

        # return 5th page
        my @last = $fml->last(5);

        # same
        my @last = $fml->last( { page => 5 } );

    And options can be mixed:

        my @not_so_last = $fml->last( { as => 'text', page => 50 } );

  credentials( $username, $password ) (NOT YET FULLY IMPLEMENTED)
    WARNING: THIS HAS NOT YET BEEN IMPLEMENTED.

    THE TESTS HAVE BEEN DISABLED FOR NOW, PLEASE WAIT FOR A MORE ADVANCED
    VERSION.

    Sets credentials for members.

        $fml->credentials( 'foo', 'bar' );

        # same thing
        $fml->username('foo');
        $fml->password('bar');

AUTHORS
    Sawyer X (XSAWYERX), "<xsawyerx at cpan.org>" Tamir Lousky (TLOUSKY),
    "<tlousky at cpan.org>"

BUGS
    Please report any bugs or feature requests to "bug-www-fmylife at
    rt.cpan.org", or through the web interface at
    <http://rt.cpan.org/NoAuth/ReportBug.html?Queue=WWW-FMyLife>.

    You can also use the Issues Tracker on Github @
    <http://github.com/xsawyerx/www-fmylife/issues>.

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

        perldoc WWW::FMyLife

    You can also look for information at:

    *   Our Github!

        <http://github.com/xsawyerx/www-fmylife/tree/master>

    *   RT: CPAN's request tracker

        <http://rt.cpan.org/NoAuth/Bugs.html?Dist=WWW-FMyLife>

    *   AnnoCPAN: Annotated CPAN documentation

        <http://annocpan.org/dist/WWW-FMyLife>

    *   CPAN Ratings

        <http://cpanratings.perl.org/d/WWW-FMyLife>

    *   Search CPAN

        <http://search.cpan.org/dist/WWW-FMyLife/>

    *   FML (FMyLife)

        <http://www.fmylife.com>

COPYRIGHT & LICENSE
    Copyright 2009 Sawyer X, Tamir Lousky.

    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.

