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";
}
my $opts = { fromTag => 'rose', toTag => 'another name' };
$sim->RenameTag($cred, $opts) || die $sim->status;
print $sim->message . "\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.
Return the message string, if any, returned by the last Simpy REST method.
REST 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};RemoveTag
Removes a tag via the Simpy API. Returns a true result if successful.
RenameTag
Renames a tag via the Simpy API. Returns a true result if successful.
RenameTag
Merges two tags via the Simpy API. Returns a true result if successful.
SplitTag
Splits a tag via the Simpy API. Returns a true result if successful.
GetLinks
Returns an hash object of links, keyed by url. Each link is in turn a hash object of link properties, keyed by property name. The 'tags' property keys an array reference of tags. All other properties tag a scalar value.
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://simpytools.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.