NAME

WWW::Simpy - Perl interface to Simpy social bookmarking service

SYNOPSIS

use Simpy;

my $sim = new Simpy;

my $cred = { user => "demo", pass => "demo" };


my $opts = { limit => 10 }; 
my $tags = $sim->GetTags($cred, $opts) || die $sim->status;

foreach my $k (keys %{$tags}) {
  print "tag $k has a count of " . $tags->{$k} . "\n";
}


my $opts = { limit => 10, q = "search" };
my $links = $sim->GetTags($cred, $opts) || die $sim->status;

foreach my $k (keys %{$links}) {
  print "url $k was added " . $links->{$k}->{addDate} . "\n";
}

DESCRIPTION

This module provides a Perl interface to the Simpy social bookmarking service. See http://www.simpy.com/simpy/service/api/rest/

THIS IS AN ALPHA RELEASE. This module should not be relied on for any purpose, beyond serving as an indication that a reliable version will be forthcoming at some point the future.

This module is being developed as part of the "tagged wiki" component of the Transpartisan Meshworks project ( http://www.transpartisanmeshworks.org ). The "tagged wiki" will integrate social bookmarking and collaborative content development in a single application.

EXPORT

None by default.

METHODS

Constructor Method

Simpy object constructor method.

my $s = new Simpy;

Accessor Methods

Return status information from API method calls.

Return the HTTP status of the last call to the Simpy REST server.

API Methods

See http://www.simpy.com/simpy/service/api/rest/ for more information about required and optional parameters for these methods.

GetTags

Returns an object has of tag/count pairs.

my $tags = $s->GetTags($cred, $opts);
print "The tag 'dolphin' has a count of " . $tags->{dolphin};

Returns an array of hash objects. Each element of the array describes a link.

CAVEATS

This is an early alpha release. Not all methods of the API are implemented, nor have the sub-modules defining data types for those API methods been developed.

SEE ALSO

http://simpyapi.sourceforge.net

http://www.transpartisanmeshworks.org

AUTHOR

Beads Land, beads@beadsland.com

COPYRIGHT AND LICENSE

Copyright (C) 2006 by Beads Land

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.6.1 or, at your option, any later version of Perl you may have available.