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, or syntax errors from the XML::Parser module, if any.
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.