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 "mesh pooling" component ofthe Transpartisan Meshworks project ( http://www.transpartisanmeshworks.org ). The mesh pool will integrate social bookmarking and collaborative content development in a single application.

EXPORT

accessorType

The accessorType property of a link may be PUBLIC or PRIVATE.

code

The Simpy status code may be any of the following constants.

   # SUCCESS                    - Success
   # PARAMETER_MISSING          - Required parameter missing
   # NONEXISTENT_ENTITY         - Non-existent entity
   # TRANSIENT_ERROR            - Transient data retrieval error
   # STORAGE_ERROR              - Entity storage error
   # QUOTA_REACHED              - Storage quota exceeded
                

METHODS

Constructor Method

Simpy object constructor method.

  my $s = new Simpy;

Accessor Methods

Return status information from API method calls.

status

Return the HTTP status of the last call to the Simpy REST server, or syntax errors from the XML::Parser module, if any, or error from Simpy REST API, if any.

message

Return the message string, if any, returned by the last Simpy REST method.

code

Return the Simpy error code, 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 a hash reference 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 reference of links, keyed by url. Each link is in turn a hash reference of link properties, keyed by property name. The value of the 'tags' property keys is an array reference of tags. All other properties tag a scalar value.

The exported constants PUBLIC and PRIVATE can be used to check the value of the accessType property.

SaveLink

Saves a link via the Simpy API. Returns a true result if successful.

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.

cpanm WWW::Simpy

perl -MCPAN -e shell
install WWW::Simpy