NAME
Net::Delicious - OOP for the del.icio.us API
SYNOPSIS
use Net::Delicious;
use Log::Dispatch::Screen;
my $del = Net::Delicious->new({user=>"foo",
pswd=>"bar"});
foreach my $p ($del->recent_posts()) {
print "$p\n";
print $p->description()."\n";
} DESCRIPTION
OOP for the del.icio.us API
PACKAGE METHODS
__PACKAGE__->new(\%args)
Valid arguments are :
user
String. required
Your del.icio.us username.
pswd
String. required
Your del.icio.us password.
debug
Boolean.
Add a Log::Dispatch::Screen dispatcher to log debug (and higher) notices. Notices will be printed to STDERR.
Returns a Net::Delicious object. Woot!
OBJECT METHODS
$obj->add_post(\%args)
Makes a post to del.icio.us.
Valid arguments are :
url
String. required
Url for post
description
String.
Description for post.
extended
String.
Extended for post.
tags
String.
Space-delimited list of tags.
dt
String.
Datestamp for post, format "CCYY-MM-DDThh:mm:ssZ"
Returns true or false.
$obj->posts_per_date(\%args)
Get a list of dates with the number of posts at each date.
Valid arguments are :
tag
String.
Filter by this tag.
Returns a list of Net::Delicious::Date objects when called in an array context.
Returns a Net::Delicious::Iterator object when called in a scalar context.
$obj->recent_posts(\%args)
Get a list of most recent posts, possibly filtered by tag.
Valid arguments are :
tag
String.
Filter by this tag.
count
Int.
Number of items to retrieve (defaults to 15)
Returns a list of Net::Delicious::Post objects when called in an array context.
Returns a Net::Delicious::Iterator object when called in a scalar context.
$obj->posts(\%args)
Get a list of posts on a given date, filtered by tag. If no date is supplied, most recent date will be used.
Valid arguments are :
tag
String.
Filter by this tag.
dt
String.
Filter by this date.
Returns a list of Net::Delicious::Post objects when called in an array context.
Returns a Net::Delicious::Iterator object when called in a scalar context.
$obj->tags()
Returns a list of tags.
$obj->rename_tag(\%args)
Renames tags across all posts.
Valid arguments are :
old
String. required
Old tag
new
String. required
New tag
Returns true or false.
$obj->inbox_for_date(\%args)
Get a list of inbox entries.
Valid arguments are :
dt
String.
Filter by this date
Returns a list of Net::Delicious::Post objects when called in an array context.
Returns a Net::Delicious::Iterator object when called in a scalar context.
$obj->inbox_dates()
Get a list of dates containing inbox entries.
Returns a list of Net::Delicious::Date objects when called in an array context.
Returns a Net::Delicious::Iterator object when called in a scalar context.
This may be updated to return a Net::Delicious::Inbox object.
$obj->inbox_subscriptions()
Get a list of your subscriptions.
Returns a list of Net::Delicious::Subscription objects when called in an array context.
Returns a Net::Delicious::Iterator object when called in a scalar context.
$obj->add_inbox_subscription(\%args)
Adds a subscription.
Valid arguments are :
user
String. required
Username.
tag
String.
Tag - leave blank for all posts
Returns true or false.
$obj->remove_inbox_subscription(\%args)
Valid arguments are :
user
String. required
Username.
tag
String.
Tag - leave blank for all posts
Returns true or false.
$obj->logger()
Returns a Log::Dispatch object.
ERRORS
Errors are logged via the object's logger method which returns a Log::Dispatch object. If you want to get at the errors it is up to you to provide it with a dispatcher.
VERSION
0.2
DATE
$Date: 2004/02/01 22:19:09 $
AUTHOR
Aaron Straup Cope <ascope@cpan.org>
SEE ALSO
http://del.icio.us/doc/api
NOTES
The version number (0.2) reflects the fact the del.icio.us API still has a great big "I am a moving target" disclaimer around its neck.
This package implements the API in its entirety as of DATE.
LICENSE
Copyright (c) 2004, Aaron Straup Cope. All Rights Reserved.
This is free software, you may use it and distribute it under the same terms as Perl itself.