NAME

WebService::Simplenote - Note-taking through simplenoteapp.com

VERSION

version 0.2.1

SYNOPSIS

  use WebService::Simplenote;
  use WebService::Simplenote::Note;

  my $sn = WebService::Simplenote->new(
      email    => $email,
      password => $password,
  );

  my $notes = $sn->get_remote_index;

  foreach my $note_id (keys %$notes) {
      say "Retrieving note id [$note_id]";
      my $note = $sn->get_note($note_id);
      printf "[%s] %s\n %s\n",
          $note->modifydate->iso8601,
          $note->title,
          $note->content;
  }

  my $new_note = WebService::Simplenote::Note->new(
      content => "Some stuff",
  );

  $sn->put_note($new_note);

DESCRIPTION

This module proves v2.1.5 API access to the cloud-based note software at Simplenote.

ERRORS

Will die if unable to connect/login. Returns undef for other errors.

METHODS

WebService::Simplenote->new($args)

Requires the email and password for your simplenote account. You can also provide a Log::Any compatible logger.

get_remote_index

Returns a hashref of WebService::Simplenote::Note. The notes are keyed by id.

get_note($note_id)

Retrieves a note from the remote server and returns it as a WebService::Simplenote::Note. $note_id is an alphanumeric key generated on the server side.

put_note($note)

Puts a WebService::Simplenote::Note to the remote server

delete_note($note_id)

Delete the specified note from the server. The note should be marked as deleted beforehand.

TESTING

Setting the environment variables SIMPLENOTE_USER and SIMPLENOTE_PASS will enable remote tests. If you want to run the remote tests MAKE SURE YOU MAKE A BACKUP OF YOUR NOTES FIRST!!

SEE ALSO

Designed for use with Simplenote:

<http://www.simplenoteapp.com/>

Based on SimplenoteSync:

<http://fletcherpenney.net/other_projects/simplenotesync/>

AUTHORS

  • Ioan Rogers <ioanr@cpan.org>

  • Fletcher T. Penney <owner@fletcherpenney.net>

COPYRIGHT AND LICENSE

This software is Copyright (c) 2012 by Ioan Rogers.

This is free software, licensed under:

  The GNU General Public License, Version 2, June 1991

BUGS AND LIMITATIONS

You can make new bug reports, and view existing ones, through the web interface at https://github.com/ioanrogers/WebService-Simplenote/issues.

SOURCE

The development version is on github at http://github.com/ioanrogers/WebService-Simplenote and may be cloned from git://github.com/ioanrogers/WebService-Simplenote.git