/ 
WWW-FMyLife-0.02
River stage zero No dependents
/ WWW::FMyLife

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:

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.