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.3

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.3) 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.

cpanm Net::Delicious

perl -MCPAN -e shell
install Net::Delicious