Aaron Straup Cope > Net-Delicious-0.7 > Net::Delicious

Download:
Net-Delicious-0.7.tar.gz

Dependencies

Annotate this POD

CPAN RT

New  2
Open  0
View Bugs
Report a bug
Module Version: 0.7   Source   Latest Release: Net-Delicious-1.13

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->description()."\n";
  } 

DESCRIPTION ^

OOP for the del.icio.us API

PACKAGE METHODS ^

__PACKAGE__->new(\%args)

Valid arguments are :

Returns a Net::Delicious object. Woot!

OBJECT METHODS ^

$obj->add_post(\%args)

Makes a post to del.icio.us.

Valid arguments are :

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 :

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 :

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 :

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 :

Returns true or false.

$obj->inbox_for_date(\%args)

Get a list of inbox entries.

Valid arguments are :

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 :

Returns true or false.

$obj->remove_inbox_subscription(\%args)

Valid arguments are :

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

DATE ^

$Date: 2004/09/17 18:41:52 $

AUTHOR ^

Aaron Straup Cope <ascope@cpan.org>

SEE ALSO ^

http://del.icio.us/doc/api

NOTES ^

The version number (0.7) 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.